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Chapter 1 Introduction 


1.1 General Information 


The AdvaTalk® Link to MATLAB® package is an option for the Advant Station 500 Series 
Information Management Station (IMS). To use AdvaTalk® Link to MATLAB, AdvalInform 
Basic Functions software and MATLAB software must be installed. AdvaInform Basic 
Functions is the minimum software required for AdvaInform and AdvaTalk options. 


The Link to MATLAB® 


This book describes the AdvaTalk Link to MATLAB (hereafter referred to as the Link to 
MATLAB). The Link to MATLAB integrates the power of MATLAB and associated toolbox 
options into the ABB Advant Open Control System (OCS). 


The Link to MATLAB is composed of an off-line interface and an on-line interface. 


The off-line interface supports read, write, and log functions that can be invoked from the 
MATLAB prompt in an asynchronous manner. 


The on-line interface uses MATLAB as a mathematical engine. Through the on-line interface 
you can execute a MATLAB script or function in cyclic fashion or when triggered (on a one- 
shot basis). Input data are read from the process at every execution and the result is distributed 
as outputs to OCS objects. 


The platform for the Link to MATLAB is the AdvaInform software. If you need to read any 
historical data other than TTD (Time Tagged Data) logs from the off-line interface, the 
AdvalInform History option must be installed on the same node as the Link to MATLAB, or on 
an accessible Advant node. 


MATLAB® 


MATLAB is a technical computing environment for high performance numeric computation 
and visualization. MATLAB integrates numerical analysis, matrix calculations, signal 
processing and graphics in an easy-to-use environment where problems and solutions are 
expressed just as they are written mathematically. This functionality is described further in 
Section 1.8, Product Overview. 


NOTE 


The MATLAB® package from The MathWorks Inc. is NOT a part of this 
option and needs to be bought and installed to make the option operational. 
The MATLAB software needs to be installed with at least one MATLAB licence 
available for the off-line interface in the node where the Link to MATLAB is 
installed. The license can be either CPU- or network-based. The on-line interface 
can use MATLAB licenses which run on other stations that are connected to 
TCP/IP. 
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Prerequisites 


To use the Link to MATLAB option, you should already know how to use AdvaInform Basic 
Functions. To learn about the AdvaInform basic functions and options, it is recommended that 
you attend the training courses provided by ABB Industrial Systems training centers. 


It is also recommended that you know how to implement and execute MATLAB scripts and 
algorithms. Contact your local MATLAB dealer or The MathWorks Inc. for more information 
on local training courses and workshops. 


1.2 Equipment Requirements 


The Link to MATLAB option runs on an Advant Station 500 Series workstation configured as 
an IMS. 


1.3 How to Use This Book 


MOD 300 and Master 
This guide covers both MOD and Master. This is handled in two ways: 


° In some cases when the operation/commands differs two alternatives are described - one 
for MOD and one for master 


° When the difference is restricted to for example object type only, the MOD alternative is 
described in brackets: ... (MOD: xxxxxxx). 
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1.3.1 Manual Organization 


Figure 1-1 shows the basic structure of the Advant documentation. Each document, whether it is 
describing and referencing hardware or software, is built around this one structure, making it 
easy for you to locate related information in any of the documents. 


Chapter 
edie 
or Heenan Runtime 
Introduction Installation ication Maintenance | | Appendices Index 
Bhilding Operation PP 
General. Site Planning Design | Product Preventive Appendix A 
Information Environment Considerations Operation Maintenance References 
Equipment Setup Capacity & Operating Hardware 
Requirements Performance Overview Indicators 
Shut-down aoe 
Manual | Procedures Application Runtime Error 
Organization Start-up Tutorial Messages 
tart-u 
Conventions Procedures Tutorial Operating Fault Finding 
—— Instructions & User Repair 
Related Product. Application 
Documentation Verification Procedures Runtime 
Si eat aa Operation ~ 
elease onfiguration/ Menus ; 
History Application Section 
; Building Menus 
Terminology 
Product 
Overview 


User Interface 


Figure I-1. Basic Document Structure 


Chapter 1, Introduction provides an overview of the Link to MATLAB. Read Section 1.8, 
Product Overview to get an introduction of the Link to MATLAB configuration and runtime 
functions. 


Chapter 2, Installation provides step-by-step instructions on how to install the Link to MATLAB 
software. Also some configuration procedures required during start-up are described in this 
chapter. Installation of the MATLAB software is described in the MATLAB documentation. 


Chapter 3, Configuration/Application Building provides guidelines for configuring the Link to 
MATLAB. A tutorial is included in this chapter to give you some quick hands-on experience. 


Chapter 4, Runtime Operation describes how to operate the Link to MATLAB in runtime. 


Chapter 5, Maintenance is helpful if you run into problems and need help using Link to 
MATLAB. 


The Appendix A provides reference information about the on-line and the off-line functions. 
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1.3.2 Differences Between Master and MOD 300 


1-4 


This manual is common for the Advant OCS Systems with MOD 300 respectively Master 
software. 


Most examples, figures and so on are from the Master system. In this section the differences 
between MOD 300 and Master for this option will be explained. These differences have to be 
considered when reading the manual. 


The following is a summary of the differences in AdvaTalk Link to MATLAB for system with 
Master software and systems with MOD 300 software. 


Object Types 


While some AdvaInform object types are common for both Master and MOD 300, the object 
types in the Advant Controllers are unique to Master or MOD 300. Refer to the applicable 
Advalnform Object Type Reference Manual for details. There is a separate manual for MOD 300 
object types and Master object types. 


MEASURE and VALUE Object Attributes 


One common object attribute for MOD 300 objects is the MEASURE attribute. The equivalent 
attribute for Master applications is VALUE. These attributes are used in some of the examples 
in this book. In some cases, two examples are provided showing both MEASURE and VALUE, 
and in other cases just one attribute or the other is shown. In all cases, the examples can be made 
applicable for both Master and MOD 300 by simply substituting the correct attribute. 


Event and Alarm Handling 
Event and alarm handling differs for MOD 300 and Master. 


System Status 
The System Status function provides two types of Status presentation and supervision: 


° Node Status - which provides all relevant status information about the Advant Station and 
AdvaInform software. 


° Network Status - which is Master specific - which provides information about the 
connected MasterBus 300 network and the status of the other Advant Master nodes. 


Control network 


The connected network in Master is called MB300/300E (MasterBus). In MOD 300 the 
network is called DCN (Distributed Control Network). The System Status functions are 
available only in Master systems. 


Off-line interface 


All functions except for getMultiDAT are common for both MOD 300 and Master. The function 
getMultiDAT is Master specific. 
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When using the getHistory function, the possibility to collect data from TTD logs only applies 
to Master. 


On-line interface 


The object type MatlabLink in Master is called MatlabLinkMOD in MOD 300. 


1.4 Conventions 


The following conventions are used throughout this manual for the presentation of material: 


° The words in proper names of screen elements (for example, the title in the title bar of a 
window, the label for a field of a dialog box) are initially capitalized. 


° The names of keyboard keys are boldfaced. 


— Initial capital letters are used for the name of a keyboard key if it is labeled on the 
keyboard. For example, the Return key or <Return>. 


— Lowercase letters are used for the name of a keyboard key that is not labeled on the 
keyboard. For example, the space bar, comma key, and so on. 


— In descriptions, the word “key” is used in conjunction with its name. For example, 
pressing the Return key initiates the process. 


— In tables and procedures, angle brackets replace the word “key.” For example, press 
<Return>. 


— A dash is used to indicate that you must simultaneously press several keys. For 
example, <Ctrl-C> indicates that you must hold down the Control key while 
pressing the C key. 


— The phrase “press and release” is used to indicate that you sequentially press several 
keys. For example, to close a window, press and release <Alt>, and then <F4>. 
This indicates that you press and release the Alt key, and then you press and release 
the F4 function key. 


° The names of push and toggle buttons are boldfaced. 


— Initial capital letters are used for the name of a push or toggle button labeled on the 
display. For example, the Cancel button. 


—  Indescriptions, tables and procedures, the word “button” is used in conjunction with 
its name. For example, pressing the OK button initiates the process. 
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° The names of menus and menu items are boldfaced. 


— Initial capital letters are used for the name of menus listed in the menu bar. 


For example, the File menu. 


— Initial capital letters are used for the name of menu items. For example, to open a 
new window, choose New from the File menu. 


° System prompts/messages are shown in the Courier font, and user responses/input are in 
the boldfaced Courier font. For example, if you enter a value out of range, the following 


message is displayed: 


Entered value is not valid. 


The value must be 0-30. 


In a tutorial, you may be told to enter the string TIC132 in a field. The string is shown as 


follows in the procedure: 


TIC132 


1.5 Related Documentation 
Table 1-1 lists all documentation related to AdvaTalk Link to MATLAB User’s Guide 


Table 1-1. Related Documentation 


Category Title Description 

Hardware Advant Station 5XX Hardware User’s Guide This book covers the installation and 
maintenance of the hardware for an Advant 
Station. 

System Advant Station 500 Series IMS User’s Guide _| This book provides instructions for system 
administration functions such as backup and 
restore. 

Advalnform Basic Functions User’s Guide This book describes the basic functions that 
support all Advalnform software packages. 

Advalnform Object Types Reference Manual ___| This book provides table names and attribute 
names for all object types supported by 
Advalnform and AdvaTalk software. 

Options Advalnform History User’s Guide This book describes, for example, how to 
configure the Numerical Logs. 

Advalnform Object Handling User’s Guide The configuration and execution environment 
for User Objects. You must have an Object 
Handling option to execute your objects. 
Required MATLAB User’s Guide The book covers the usage of MATLAB. 
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Version 


Description 


1.0 


The first release of the AdvaTalk Link to MATLAB option. 


1.1 


Support of MATLAB 5.0, and HP-UX 10.20. 


1.7 Terminology 


Advalnform History An Advalnform option that supports storage and retrieval of historical data 


Attribute 


Core System 


History Builder 
IMS 


IMS menu 


Object 


OS 
SQL*Plus 


MATLAB 
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in a number of different log types. 


The part of any object in the core system that is visible or accessible by 
other object types or via SQL queries. 


All nodes in the distributed control system communicate with each other 
through the Core System. The Core System provides services for the 
system applications. Using these services, the system applications can 
communicate with each other whether they reside in the same node or in 
separate nodes of different types. The type directory, which is part of the 
core system, contains information on all known object types. 


The configuration tool in Advalnform History. 
Short for Advant Station 500 Series Information Management Station. 


The menu that provides access to Advalnform Basic Functions as well as 
optional functions. It is the main menu of IMS. 


In the core system (see above) all entities) that are accessed by several 
sub-systems (or parts of sub-systems running in separate nodes) are 
represented as global objects. 

There are two categories of global objects: 

System Objects 

Entities representing parts of the system itself. Examples are field 
interface devices (that is hardware devices), printers, communication 
links, sub-systems, entire nodes, and so on. 

Application objects 

Entities representing the user application. Examples are User objects, 
History logs, Batch control recipes, and so on. 


Short for Advant Station 500 Series Operator Station. 


From the IMS menu you can open a Database Access window and enter 
SQL*Plus queries. You are then automatically logged in as an Oracle user 
and you can use SQL and PL/SQL queries into database tables and 
views. 


Math software package from The MathWorks Inc. 
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DCS / OCS Distributed Control System / Open Control System 
GUI Graphical User Interface 


(1) This refers on the first hand to entities that are normally visible to end users. We will for 
example normally not encapsulate HP-UX utilities in this object model. 
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1.8 Product Overview 


1.8.1 What is MATLAB? 


MATLAB does for the control & instrumental engineers or researchers, what the CAD tool does 
for mechanical engineers. MATLAB is a technical computing environment for high 
performance numeric computation and visualization. MATLAB integrates numerical analysis, 
matrix computation, signal processing, and graphics in an easy-to-use environment where 
problems and solutions are expressed just as they are written mathematically. 


MATLAB also features a family of application-specific solutions called toolboxes. Toolboxes 
are comprehensive collections of so called m-files (so denoted because of their extension .m) 
which are ordinary text files containing MATLAB code. In addition, any user can extend the 

functionality of MATLAB by writing their own m-files. 


Source code written in C or FORTRAN can also be integrated with MATLAB by letting it 
comply with the External Interface described in the MATLAB documentation. This can be used 
for example to read or write to proprietary nodes on the TCP/IP network or to integrate existing 
process models, optimization routines or database applications. 


Some of the toolboxes available from The MathWorks Inc. include: 


° Signal Processing Toolbox for one- and two-dimensional digital signal processing (time- 
series analysis). This toolbox contains functions for digital filters, power spectrum 
estimation (FFT analysis), and others. 


° Control Systems Design Toolbox for control engineering and systems theory, with an 
emphasis on state-space techniques. 


° System Identification Toolbox for parametric modeling and system identification. It 
specializes in estimating models of a system based upon input-output data, or on time- 
series. 


° Neural Network Toolbox for designing and simulating neural networks. Functions for 
network simulation, network parameters and for training networks on data are included. 


° Spline Toolbox for modeling functions of a more or less arbitrary nature. This toolbox is 
useful for modeling curves, passing curves through data, solving functional equations, and 
performing functional approximations. 


° Robust-Control Toolbox for robust control system design, including LQG/loop transfer 
recovery, H2 and He control synthesis for singular value frequency response and for 
model reduction. 


° u- Analysis and Synthesis Toolbox for the analysis and design of robust linear control 
systems for 1. -Analysis and Synthesis. 


° Other toolboxes such as Fuzzy Logic, Chemometrics, Image Processing, Statistics and 
MATLAB Compiler / MATLAB C Math Library are also available from The 
MathWorks Inc. or other dealers. 


For a complete and updated list of toolboxes, contact your local MATLAB dealer or The 
MathWorks, Inc. 
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1.8.2 Product Structure 


The Link to MATLAB is an AdvaTalk software option that runs on an IMS, Figure 1-2. The Link 
to MATLAB integrates the power of MATLAB and associated toolbox options as a part of the 
Advant OCS. 


If you need to read any historical data other than TTD (Time Tagged Data) logs from the off- 
line interface, the AdvaInform History option must be installed on the same node as the Link to 
MATLAB, or on an accessible Advant node. 


User Interface 
Advalnform User API 


System Functions 
SQL*Connect 
Link to MATLAB 
History 


Operating System 


Communication SW Relational Database 


Hardware 


Advant OCS Network 


Figure 1-2. The AdvaTalk Link to MATLAB in IMS 
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The AdvaTalk Link to MATLAB option is divided in two parts, the off-line and on-line 
interface, as shown in Figure 1-3. 


Off-line part On-line part 
Matrix storage/retrieval 
a Oracle DB MATLAB 
Advatalk 
Ean to MATLAB, (MATLAB 
Hist AdvatTalk 
ery Link to MATLAB 
Advalnform Basic Functions 


Advant OCS network 


Figure 1-3. Off-line and On-line Interface 


1.8.2.1 Off-line Interface 


The off-line interface supports read, write, and log operations from the MATLAB prompt in an 
asynchronous manner. There are some restrictions on text and composite attributes that can be 
read and logged due to lack of representation in the MATLAB environment. The basic rule is 
that every value that has any relevance when converted to the datatype double is converted and 
sent to MATLAB’s workspace. 


The interface also supports the means to perform, for example, an identification experiment. 
That involves logging data to file and changing/exciting the process using Advant OCS objects. 
The result available for analysis and model building using MATLAB functionality. 


For off-line identification, History and object data can be incorporated into MATLAB 
workspace directly from the MATLAB prompt. You can get/set values in the Advant OCS from 
the MATLAB prompt. The off-line interface also supports database storage of data matrices 
from the MATLAB workspace into the AdvaInform database. Each matrix is stored 
independently in database tables, accessible via SQL. These matrix functions are accessible 
from the MATLAB prompt. 


1.8.2.2 On-Line Interface 
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The on-line interface consists of an object type, MatlabLink, and its configuration display. 
Every instance of the MatlabLink object type creates a connection to a MATLAB engine 
(MATLAB process). After that the instances can execute a MATLAB script or function 
cyclically, when triggered (one-shot basis), or via a command from, for example, a User API 
program. 
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Each instance copies values from connected OCS objects to the MATLAB engine workspace 
where a script executes and processes the input data. An output matrix from the script is copied 
back to the instance where the output connections (OCS objects) are updated with new values. 


The on-line interface can handle several matlab licences at the same time or let more than one 
instance share the same licence and thus the same workspace. 


1.8.3 Examples of Applications 


The Link to MATLAB allows both on-line and off-line verification of the algorithm prior to 
implementation. This simplifies the development process by only needing to implement an 
already tested algorithm. MATLAB also supports automatic code generation tools from 
MATLAB scripts which will further enhance the R&D process. 


Some examples of Link to MATLAB applications are: 


° searching for plant control problems, such as oscillations and other types of analysis of 
historical data. 


° the ability to avoid the tedious step where the control algorithm first needs to be 
implemented before any test against real-data could be done. The on-line interface allows 
you to use the MATLAB algorithm directly. 
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° incorporating new sensor information like video displays, high speed logging of vibration 
or sound and spectrophotometric data from nodes on the TCP/IP network (the signals are 
filtered using MATLAB image or signal processing facilities and then used for calculating 
new process parameters). 


New products can be tested on-line against a real process without the need to first integrate 
the prototype and then start testing. 


° new control engineering algorithms can be verified prior to implementation. 


The algorithm that is implemented is also fully tested which will further decrease the 
development time and overall software quality. 


° product development and integration. 


Since The MathWorks Inc. also supports source code generation from MATLAB scripts, a 
proven algorithm can be even further integrated in the Advant OCS using the AdvaBuild 
Object Type Builder option. 


The AdvaTalk Link to MATLAB will reduce the development time in the last three or four 
steps mentioned above. It will also allow R&D groups that uses MATLAB as a 
development environment to test the algorithm directly without the need to start 
implementing the algorithm prior to on-line testing. 


The algorithm that is implemented is also fully tested which will further decrease the 
development time and overall software quality. 


° any other area where MATLAB is used as a prototype environment for process 
applications. 


1.8.4 Functional Description 


1.8.4.1 Off-line Interface Functions 


The off-line interface consists of a set of routines that can be executed from the MATLAB 
prompt, Figure 1-4. Each user that starts MATLAB can also use the off-line interface. The off- 
line interface provides functions for: 


° Object access 
° Logging attribute values to file 
° History read access 


° Database storage/retrieval of matrices 


Further details are given in Section A.3, Off-line Functionality. 
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>> 
>> 


>> logAttribute... 
>> setObj... 


Oracle storage/retrieval | Link to MATLAB 
of matrices Oracle DB 
History 
MATLAB AdvatTalk 


Link to MATLAB. | History 
Off-line server y Access 


Object coer 


Advalnform Functions 


Advant OCS network 


Figure 1-4. Off-line Interface 


Object Access 


Certain limitations exists concerning the number of attributes or objects requested in one call. 
Only those attributes that can be converted to a relevant double value are available. For 
example, the description attribute for an object is not available. 


The following functions are available: 
° resolveObj 
This function resolves one or several object instances. 
° describeObj 
This function describes all attributes for one given object name or object type. 
° getAttribute 
This function reads a number of attributes for a given object name. 
° getMultiDAT 


This function reads a number of consceutive DAT objects of the same type. The maximum 
number of values in one MultiDAT is 50. 


° setObj 


This function changes the value of one or several object attributes. 
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Logging Attribute Values to File 
° logAttribute 


The logAttribute function runs independently of the MATLAB process. This function 
starts a log to file process. The object attributes that are logged are given as an input file. 
The logged values are stored as an ASCII file. 


History Access 
° getHistory 


If the History option is installed, both TTD logs (Master) and History logs are accessible. 
Both the composite log name and the numeric log name can be used to make a call for 
History values. 


A maximum of 500 values can be retrieved simultaneously from a History log, and put 
into the MATLAB workspace. For a TTD log the maximum is 402. 


Oracle Storage of Matrices 


These functions let you store and retrieve a matrix defined in the MATLAB workspace outside 
MATLAB. All stored matrices can be accessed by the OCS independent of the MATLAB 
package. The matrix name and description are defined by you. There are no limitations 
regarding the number of values that can be stored, other than the available Oracle table space. 


The following functions are available: 
° storeMatrix 
Stores a matrix from MATLAB workspace in the Oracle DB. 
° readMatrix 
Retrieves a matrix stored in the Oracle DB back to the MATLAB workspace. 
° deleteMatrix 
Deletes a specific Matrix in the Oracle DB. 
° listMatrix 


Lists matrices that are present in the Oracle DB. 


1.8.4.2 On-line Interface Functions 


With the on-line interface you can integrate the MATLAB power of arithmetic functions, 
presentation, and script language into the Advant OCS. Thus, any MATLAB application that 
needs process data as input and the ability to present and distribute the result back to the 
process, can now be an integrated part of the Advant OCS. 
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MATLAB process 


- Receive input vector 
- Execute script 
- Create output vector 


MatlabLink instance 


- Read input connections 

- Send input vector to MATLAB 

- Notify MATLAB to execute script 
- Read output vector from MATLA 
- Update output connections 


MATLAB 
process 


Object Handler 


MatlabLink 
instance 


MatlabLink 
instance 


< Advalnform Basic Functions v 


Advant OCS network 


Figure I-5. On-line Interface 


The on-line interface is linked to MATLAB as a new object type, MatlabLink. Each instance of 
the MatlabLink object type can be configured to execute any MATLAB script or function 

(see Section 3.5.7, Description of Attributes/Connections for further information). Execution of 
each instance can be done in the following way: 


on command from, for example, a User API program. 


triggered from another MatlabLink instance. This can be used if several instances must be 
synchronized to each other. 


cyclic, for example, each 5th second or once every hour. 


as a combination of the methods above. 


Execution 


Cyclic 1 second execution is the shortest cycle time that can be used. 


Trigger Event 


You can generate an event from a MatlabLink instance. This event can be used to trigger other 
instances of the same type or new object types in order to arrange a synchronized execution 
order. 
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1.9 User Interface 
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Input and Output Vectors 


An input vector can be sent from the executed instance to the MATLAB workspace at each 
execution. Then, MATLAB can create a vector that can be sent back to the instance. The names 
of both vectors are configurable in attributes of the created instance. 


The input vector is created from input connections of float and boolean type. A maximum of 64 
float and 32 boolean input values can be sent to the MATLAB workspace. The values that are 
used to update the output connections are read from the collected vectors that were created in 
the MATLAB script that the instance executed. 16 DAT real and 16 DAT boolean output 
connections can be updated by each instance. 


Standard display elements or dialogs in an OS node can be used to present the objects connected 
to the MatlabLink object type. 


MATLAB Licence and Start-up 


The on-line interface supports several MATLAB licenses (MATLAB processes) to be active at 
the same time. An instance can only connect to one MATLAB process at a time. 


The MATLAB software can be installed either on a server connected to the IMS node over the 
TCP/IP network or local, in the IMS node. 


When an instance is started it either connects to an already started MATLAB process or a new 
one. Executing one instance is equal to creating or updating two MATLAB matrices in the 
MATLAB workspace and executing a MATLAB script from the prompt. 


Error Messages 


Error messages from the Link to MATLAB are issued as system messages to the System 
Messages log. This log is displayed when you choose System Messages from the Station 
menu. 


You can also send a return code as an integer value from the executed MATLAB script back to 
the attribute RETURN_CODE in the executed instance. This attribute is accessible via SQL- 
Plus. 


The different system messages that are issued from the on-line interface are listed in Chapter 5, 
Maintenance. Status bits are explained in Chapter 4, Runtime Operation. 


The user interface to the off-line part is the MATLAB standard environment with prompt 
access, plot and the Handle Graphics available. 


The on-line part has the same user interface as the off-line part except for the prompt access. 
The input and output data can also be accessed and presented using the standard display 
elements and dialogs in any OS node. 


The display for configuration and stop/start operations in the on-line interface is the same as in 
the AdvaInform Object Handling option. 
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2.1 Site Planning Environment 


2.2 Setup 


2.2.1 Hardware 


The Link to MATLAB requires the AdvaInform Basic Functions for operation. See the Advant 
Station 500 Series IMS User’s Guide for information about site planning, installation and 
diagnostics. 


For details regarding the hardware, refer to the Advant Station 500 Series IMS User’s Guide and 
the relevant Advant Station 5xx Hardware User’s Guide. 


2.2.2 Software Installation and removal 


Generally, the AdvaTalk Link to MATLAB software is loaded onto the Advant Station at the 
factory prior to delivery. Therefore, you generally do not have to load the software. 


If you, for some reason, have to install or remove the MATLAB software, refer to the Advant 
Station 500 Series IMS User’s Guide for instructions. 


2.2.2.1 Off-line Start-up Configuration 
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Before you can start the MATLAB window from the IMS main menu, a System Variable has to 
be configured. 


NOTE 
If the MATLAB home directory is /usr/local/matlab, this procedure is not 


necessary. 
To configure a system variable: 

1. Log into the machine as user ocsmgr. 

Start the IMS main menu and choose System Variables from the Settings menu. 


Click on the variable MATLABLINK_MATLAB. 


oS 


Locate the start-up command part of the definition line for the variable. The default start- 
up command for MATLAB, /usr/local/matlab/bin/matlab, has to be changed to the 
appropriate command on your machine. 
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5. Click on the Apply button. 


6. Exit the window: Choose Exit in the File menu. 


2.3 Shut-down Procedures 


The AdvaTalk Link to MATLAB configuration is an interactive tool which you can terminate at 
any time. The on-line run time environment, the matlablinkhandler (modmatlablinkhandler for 
MOD 300) , together with its MATLAB processes, and the off-line interface server are 
automatically stopped when the Advant Station 500 Series IMS is stopped. This procedure is 
covered in the Advant Station 500 Series IMS User's Guide. 


2.4 Start-up Procedures 


2-2 


The AdvaTalk Link to MATLAB on-line facilities are automatically available as part of the 
Advant Station 500 Series IMS start-up. This procedure is covered in the Advant Station 500 
Series IMS User’s Guide. The off-line functions are only available in each MATLAB workspace 
that have started the off-line server process. 


The AdvaTalk Link to MATLAB on-line configuration tool is started from the IMS main menu. 
Choose Link to MATLAB from the AdvaInform menu, and then choose Configuration from 
the sub-menu. 


The AdvaTalk Link to MATLAB off-line facilities are made available by executing a MATLAB 
script, off-line, from the MATLAB prompt. The script resides in the directory 
/opt/advant/MatlabLink/ocsfunc. 


A window with anew MATLAB process and the environment variable MATLABPATH updated 
with the path to the off-line server start script, can be started from the IMS main menu by 
choosing Link to MATLAB from the AdvaInform menu and then choosing MATLAB from 
the sub-menu. 


How to log in to IMS and how to open the IMS main menu is described in the Advalnform Basic 
Functions User’s Guide. 
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2.5 Product Verification 


3BSE 013 989R0001 


When the AdvaTalk Link to MATLAB Configuration display is activated, choose Help-On 
Version from the Help menu to determine the object configuration version. 


Choose System Status from the Station menu to start the System Status function and then 
select Node Status. Verify that the SOFTWARE column contains the item Link to MATLAB. 


Choose System Messages from the Station menu to display the System Messages display. Then 
verify that no system messages have occurred that are related to the installation. Search for 
references in the Process column to the matlablinkhandler (Master) or modmatlablinkhandler 
(MOD 300). 
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Chapter 3 Configuration/Application Building 


3.1 Design Considerations 


This section describes what you should consider before you begin configuring your instances of 
the MatlabLink object type. Read this section carefully before you start configuring. This may 
help you avoid some unpleasant surprises when you begin using the option. 


3.1.1 On-Line interface 


The following questions and answers point out some important considerations for configuring 
the option: 
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Is the number of input connections in one instance enough to incorporate the required 
process data into the MATLAB workspace? 


If not, then you can use several instances and let the first one be the “root” instance 
configured for cyclic execution. Let the “root” instance trigger the second instance, let the 
second instance trigger the third one and so on. Let all instances share the same MATLAB 
process. For further information see Section 3.5, Application Procedures. 


Do you have several instances that share the same MATLAB process and want to be able 
to separate or identify the data from each instance? 


If so, use different input and output vector names for each instance to separate the data. If 
several instances use the same vector name, the matrix in MATLAB will be updated of 

each instance. If it is necessary to use the same name, then use the HEADER_ID attribute 
to identify each instance. For further information see Section 3.5, Application Procedures. 


Do you wish to display the MATLAB graphics on another terminal? 


If so, see Section 3.5, Application Procedures for examples of how to configure the start- 
up command attribute. 


Do you wish to use a MATLAB license which resides on another machine? 


If so, see Section 3.5, Application Procedures for examples of how to configure the start- 
up command attribute. Remember that the MATLAB script must reside on the machine 
where the license resides. Also the diary files that are produced will reside on that 
machine. 


The MATLAB script that shall execute must reside in the directory configured in the path 
attribute. 


Any diary files produced from the executed MATLAB script will reside in the directory 
configured in the working directory attribute. 
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3.2 Capacity and Performance 


See the Advant Station 500 Series User’s Guide for details on Capacity and Performance. 


3.3 Application Start-up 


The Link to MATLAB software is started from the IMS menu. Instructions for logging in and 
accessing the IMS menu are provided in the Advalnform Basic Functions User’s Guide. 


Once the IMS menu is displayed, to start the Link to MATLAB software, choose Link to 
MATLAB item from the AdvaInform menu. This displays a sub-menu. Choose either 
Configuration to configure instances of the MatlabLink object type (as described in this 
chapter), or MATLAB for off-line operation (as described in chapter 4). 


3.4 Tutorial 


3.4.1 Data Logger and Presentation 


This tutorial describes a Master example how to implement a simple data logger using the Link 
to MATLAB on-line interface. The data logger consists of an instance of the MatlabLink object 
type and a MATLAB script which will be executed by the instance. 


The following parameters and conditions are used for this tutorial: 
° The Link to MATLAB option is running on an IMS connected to a control network. 


° An Advant Controller is connected to the same control network. The objects to be logged 
and updated reside in the Advant Controller. 


° MATLAB is installed and its home directory is /usr/local/matlab. 
° The MATLAB script tutorial1.m resides in the directory /tmp. 
° The name of the input vector used in the script is testin. 
° The name of the output vector used in the script is testout. 
° The object names are: 

— FLOAT_INPUTI: AIC71_1 

— FLOAT_INPUT2: AIC71_2 

— FLOAT_INPUT3: AIC71_3 

— FLOAT_INPUT4: AIC71_4 

- DAT_BOOL_INPUT1: DAT71_1 

— DAT_BOOL_INPUT2: DAT71_2 

— DAT_REAL_OUT1: DAT71_3 

- DAT_BOOL_OUT1: DAT71_4 
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The MATLAB script 


The script, shown below, sums the first four float inputs and performs an AND-operation with 
the two first boolean inputs. Then it presents the result in a graphical MATLAB display and 
copies the result values to the output vector which will be sent back to the MatlabLink instance 
where they can be used to update some output connections. In Figure 3-1 you can see the 


graphical MATLAB display. 
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Figure 3-1. The Graphical MATLAB Dispaly 


tutoriall.m 


presentation of the result. 
the MatlabLink instance. 
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input vector of dimension 120: testin 


output vector of dimension 50: 


JP oP ol 


testout 


Data logging of the first four real inputs and the two first 
boolean inputs with some operations on the data and graphical 
The result is also sent back to 
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fo) 


% extract parts from input vector 
inFloat = testin(1:64); 

inBool = testin(65:96); 
firstexec = testin(99); 

% Summation of float inputs: 
outFloat=[]; 

outFloat(1) = sum(inFloat (1:4)); 


fo) 


% And operation on boolean inputs: 
outBool=[]; 
outBool(1) = inBool(1)*inBool (2); 


fo) 


%& Assemble output vector 

testout = [outFloat(:)’ outBool(:)’ zeros(1,18)]; 
% Create window if first execution. 

if firstexec==1 

sampletime = 5; 

samplecounter=0; 


xlim=sampletime*10; 


ML 2 fig = figure(‘Name’, [‘AdvaTalk Link to MATLAB Test 
Instance’ ], 
‘NumberTitle’,’off’,’backingstore’,’off’); 


for j=1:4 
hi = subplot (11,3, 6* 35-5); 
h_ax = [h_ax hi]; 


set (hi,’XLim’, [0 xlim],’YLim’,[0 25]) 
ylabel (sprintf (‘*RI%g’,j4)) 
xlabel (‘time’) 


end 
hi = subplot (11,3,12); 
h_ax = [h_ax hi]; 


set (hi,’XLim’, [0 xlim],’YLim’, [0 100]) 
ylabel(*‘*DRO1’ ) 
xlabel (‘time’) 


for j=1:2 
hi = subplot (11,3,6*4j+19); 
h_ax = [h_ax hi]; 


set (hi,’XLim’, [0 xlim],’YLim’,[0 1]) 
ylabel (sprintf (‘*DBI%g’, 4) ) 
xlabel (‘time’) 

end 
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hi 


h_ax = [h_ax hi]; 


= subplot (11, 3,30); 


set (hi,’XLim’, [0 xlim],’YLim’, [0 1]) 


ylabel (‘DBO1’) 
xlabel ( ‘time’ ) 


end 
% Initialize boolean data vectors. 
if samplecounter == 0 
boolinl = 0; 
boolin2 = 0; 
booloutl = 0; 
end 


% Move data values in the vectors. 


realinl inFloat(1) realinl(l:samplecounter) ]; 
realin2 = [inFloat (2) realin2(1:samplecounter) ]; 
realin3 = [inFloat (3) realin3(1:samplecounter) ]; 
realin4 = [inFloat (4) realin4(1:samplecounter) ]; 
realoutl = [outFloat(1) realoutl(l:samplecounter) ]; 
boolinl = [inBool (1) boolinl (1) 
boolinl (1: (2*samplecounter) )]; 
boolin2 = [inBool (2) boolin2(1) 
boolin2 (1: (2*samplecounter) )]; 
booloutl = [outBool(1) boolouti1 (1) 
booloutl1 (1: (2*samplecounter) )]; 
xvecreal = [0:sampletime: (samplecounter*sampletime) ]; 
xvecbool = [xvecbool (samplecounter*sampletime) 
(samplecounter*sampletime) ]; 
samplecounter=samplecountertl; 
else 
realinl = [inFloat (1) realinl(1:50)]; 
realin2 = [inFloat (2) realin2(1:50)]; 
realin3 = [inFloat(3) realin3(1:50)]; 
realin4 = [inFloat (4) realin4(1:50)]; 
realoutl = [outFloat(1) realout1(1:50)]; 
boolinl = [inBool (1) boolinl(1) boolinl(1:100)]; 
boolin2 = [inBool (2) boolin2(1) boolin2(1:100)]; 
booloutl = [outBool (1) boolout1(1) boolout1(1:100) ]; 
end 
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% If first sample, create axes. 


if samplecounter == 1 
axes (h_ax (1) ) 
L1 = line(*XData’, xvecreal,’YData’,realinl,’Color’,’red’); 
axes (h_ax (2) ) 
L2 = line(*XData’, xvecreal,’YData’,realin2,’Color’,’blue’); 
axes (h_ax (3) ) 
L3 = line(‘*XData’, xvecreal,’YData’,realin3,’Color’,’green’); 
axes (h_ax (4) ) 
L4 = line(‘*XData’, xvecreal,’YData’,realin4,’Color’,’yellow’); 
axes (h_ax (5) ) 
L5 = line(‘*XData’, xvecreal,’YData’,realoutl,’Color’,’green’); 
axes (h_ax (6) ) 
L6 = line(*XData’, xvecbool,’YData’,boolinl,’Color’,’red’); 
axes (h_ax (7) ) 
L7 = line(*XData’, xvecbool,’YData’,boolin2,’Color’,’blue’); 
axes (h_ax (8) ) 
L8 = line(‘*XData’, xvecbool,’YData’,booloutl1,’Color’,’green’); 
else 
set (L1,’XData’, xvecreal,’YData’,realinl); 
set (L2,’XData’, xvecreal,’YData’,realin2); 
set (L3,’XData’, xvecreal,’YData’,realin3); 
set (L4,’XData’, xvecreal,’YData’,realin4); 
set (L5,’XData’, xvecreal,’ YData’,realoutl); 
set (L6,’XData’, xvecbool,’YData’,boolinl); 
set (L7,’XData’, xvecbool,’YData’,boolin2); 
set (L8,’XData’, xvecbool,’ YData’,booloutl1); 
end 


The Configuration Procedure 
To configure a simple data logger using the Link to MATLAB on-line interface: 
1. Login to the node as a user of the engineer category. 
2. From the IMS menu, open the Configuration window. 
a. Choose Link to MATLAB from the AdvaInform menu. 
This displays a sub-menu. 
b. Choose Configuration from the sub-menu. 


This opens the Object Configuration window, Figure 3-2. 
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Parts 


ENGINE_STARTUP 
LINK_DEFINITION 
MATRIX_DEFINITION 
SYNCHRONIZATION 
FLOAT_INPUT 
DAT_BOOLEAN_INPUT 
DAT_REAL_OUTPUT 
DAT_BOOLEAN_OUTPUT 


4 ABB standard mormal_operation 


Attributes/Connections attribute: USE_SAME_ENGINE_AS 
USE SAME ENGINE AS 


STARTUP_COMMAND 
PATH | 


WORKING DIRECTORY ; 
MATLAB_COMMAND 
HEADER_ID 

USE_SEND_EVENT 

USE_SCRIPT_EVENT 

USE_RETURN_CODE 

BAD_DATA_LIMIT 

INPUT_VECTOR_NAME 

OUTPUT_VECTOR_NAME 

DEFAULT_FLOAT 

DEFAULT_BOOLEAN 

TRIGGER_SIGNAL 


Figure 3-2. The MatlabLink Object Configuration window. 


3. In the Configuration window, choose New from the File menu. 


This creates a new instance. 


4. Enter the name of the instance, Logger_1, and a description if necessary. 


5. Configure the following attributes as described below: 
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STARTUP_COMMAND 

Enter the MATLAB start-up command to the MATLAB engine you will use: 
/usr/local/matlab/bin/matlab 

PATH 

Enter the path to where the MATLAB script resides: /tmp 
MATLAB_COMMAND 

Enter the name of the edited MATLAB script without the .m suffix: tutoriall 
INPUT_VECTOR_NAME 


Enter the name of the input vector that is used in the MATLAB script: testin 
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—- OUTPUT_VECTOR_NAME 
Enter the name of the output vector that is used in the MATLAB script: testout 
— FLOAT_INPUTI1 - 4: 
Enter the object names: AIC71_1 to AIC71_4 
— DAT_BOOL_INPUT1 - 2 
Enter the object names: DAT71_1 to DAT71_2 
—-  DAT_REAL _OUTI1 
Enter the object name: DAT71_3 
- DAT_BOOL_OUT1 
Enter the object name: DAT71_4 
Configure the execution interval to 5 seconds: 
a. Select Execute from the File menu. 
b. | Enable cyclic execution. 
c. Enter 5 in the Interval field. 
d. Click on <OK>. 
To save the instance, choose Save from the File menu. 


To start the instance, click on <Start>. 


3.5 Application Procedures 
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You must configure an instance of the MatlabLink object type before it can be executed and 
used in the run time environment. This is done via the Object Configuration window, 

Figure 3-3. This window is refered to simply as the Configuration window in the sections that 
follow. 


This section begins with an overview description of the Configuration window, followed by 
step-by-step instructions for the procedures for configuring. This section covers all 
configuration methods, including those not covered by the tutorial. The application procedures 
described in this section are: 


Section 3.5.2, How to Select an Object to Configure 

— Section 3.5.2.2, How to Open an Existing Object 
- Section 3.5.2.3, How to Create a New Object 
Section 3.5.3, How to Configure Attributes/Connections 
Section 3.5.4, How to Save an Object Configuration 
Section 3.5.5, Help Message Box 


Section 3.5.6, How to Configure Object Execution 
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3.5.1 Object Configuration Window Overview 


To open the Object Configuration window, choose Link to MATLAB from the AdvaInform 
menu, and then choose Configuration from the sub-menu. 


General Sto 


pbleck Name: Regulator Object state: Stopped 


‘Attribute: USE SAME _ENGINE_AS 


ENGINE_STARTUP 
LINK_DEFINITION STARTUP_COMMAND 
MATRIX_DEFINITION PATH 
SYNCHRONIZATION WORKING _DIRECTORY 
Attribute/ FLOAT_INPUT MATLAB_COMMAND 
Connection DAT_BOOLEAN_INPUT HEADER_ID 
Selection DAT_REAL_OUTPUT USE_SEND_EVENT 


DAT BOOLEAN OUTPUT _ /USE_SCRIPT_EVENT 
USE_RETURN_CODE 
BAD_DATA_LIMIT 
INPUT_VECTOR_NAME 
OUTPUT_VECTOR_NAME 
DEFAULT_FLOAT 
DEFAULT_BOOLEAN 
TRIGGER_SIGNAL 


Attribute/Connection 
Configuration 


Figure 3-3. Object Configuration Overview 
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The Configuration window has three areas as described below and shown in Figure 3-3. 


General 


Attribute/Connection 
Selection 


Attribute/Connection 
Configuration 


This provides general information such as object type and 
name, description, Normal Operation, and current 
execution state. Object execution can be started and 
stopped by clicking on dedicated push buttons in this area. 


This area has two selection boxes for selecting the 
attribute/connection you wish to work with. 


The selected attriobute/connection is displayed in this area. 
Here you can specify a new value for the selected 
attribute/connection. The fields and buttons in this area 
vary, depending on whether you select an attribute, single 
connection, or object connection. The Attribute view is 
shown in Figure 3-3. 


The purpose and operation of the fields and buttons in this window are described below: 


Object Name 


Object Type 


Description 


Object State 


Start 


Stop 
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This field indicates the name of the object whose view you 
have opened in this window. The name is defined when you 
open a new object as described in Section 3.5.2.3, How to 
Create a New Object. 


This field indicates the object type for the object whose view 
you have opened in this window. The only object type 
available in this option is MatlabLink. 


This field indicates the description for the object whose view 
you have opened in this window. The description is an 
optional text string that you can use to further identify the 
object. The description is defined when you open a new 
object as described in Section 3.5.2.3, How to Create a 
New Object. 


This field indicates the current object state which can be 
Started or Stopped. 


Click on the Start button if Stopped is displayed in the 
Object State field and you want to start the object. If the 
object is already started, or if the object is not open for write 
access, the Start button is dimmed and cannot be selected. 


Note: You must save any modifications made to the object 
(File - Save) before you can start it. 


Click on the Stop button to stop a started object. You must 
click on the Start button to make the object begin executing 
again. If the object is stopped, the Stop button is dimmed 
and cannot be selected. You can click on Stop even if the 
object has been modified since the last time it was saved. 
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Normal Op 


Parts 


Attributes/Connections 


Attribute/Connection 
Configuration 


OK 


Cancel 


Help 
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Shall always be 1. 


For large and complex object types, attributes and 
connections are often split into several parts to give you a 
better overview and better documentation of the object 
type. Each part consists of a number of attributes and/or 
connections. Select the part you wish to configure from the 
Parts list. The part name is highlighted and the 
corresponding list of attributes and connections is displayed 
in the scrolled Attributes/Connections list to the right. 


This area displays the attributes/connections for the 
selected part. 


The purpose and operation of the buttons in this area varies 
depending on whether you select an attribute, single 
connection, or object connection. Refer to the applicable 
section listed below: 


- Section 3.5.3.1, Attribute Configuration Dialog 

- Section 3.5.3.2, Single Connection Configuration Dialog 
- Section 3.5.3.3, Object Connection Dialog 

Click on OK to confirm and save your entries. When you 


save the object, the information is made part of the object 
configuration. 


Click on Cancel to delete all information entered since the 
last OK. Cancel retrieves the object attribute (or 
connection) as defined when the object was retrieved or 
when the last OK was implemented. 


Click on Help for information about this window. 


3.5.2 How to Select an Object to Configure 


3.5.2.1 Authorization 
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You can either open an existing object to work with, or create a new object. 


When you select an object, an attempt is made to open it for read and write purposes. 

If the object is active, write access is not granted. If someone else using a configuration window 
has received write access to the object, your request is denied. Only one user can write access an 
object at one time. Access is granted on a first-come, first-served basis. 


To configure an active object, you must stop it. When the object is stopped, you are 
automatically granted write access. After a successful configuration, start the object again. 


If you try to change objects that are started or that do not have write access, a warning message 
informs you that you only have read access. 
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3.5.2.2 How to Open an Existing Object 
To open an existing object: 
1. Choose Open from the File menu. 


This displays the Object selection dialog box, Figure 3-4. 


MatlabLink Engine1 


Regulator1 
Regulator2 
Valvel 


Valve2 


alve3 


Selection 


Figure 3-4. The Object selection dialog box. 


2. To select the object instance that you want to open you can either enter the object name 
directly in the Selection field, or double-click on the name in the right selection box. 


3. Click on OK to confirm the selection and close the dialog box, or click on Apply to 
confirm the selection and keep the dialog box open. 


NOTES 


The configuration tool works locally in the node where it executes, so you can 
only use it to display and configure objects and object types residing in that node. 
The objects specified in the connections, however, may reside anywhere in the 
entire system. 


For further information regarding the Open object dialog, refer to Section 3.6.1.2, 
File - Open. 
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3.5.2.3 How to Create a New Object 


When you create a new object you must specify a name for the object. You may also enter a 
description to further identify the object. To create a new object: 


1. Choose New from the File menu. 


This displays the New Name dialog box, Figure 3-5. 


Figure 3-5. The New Name dialog 


2. Enter the name in the New object name field and click on <OK>. 
The object name must be unique within the node. 


The new object is created after you enter the object name and it is accepted as legal. All 
attributes are set to default values for the object type. The first available Normal Operation is 
selected. Cyclic execution is made inactive. The new object is displayed by default, and the first 
attribute in the attribute list is selected and displayed. 


After you have entered the name you can enter a description. You can do this directly in the 
Description field in the Configuration window, Figure 3-6. 


= _ Object Configuration 


Object Name: Object £ 


Regulator 


Object Type: [a saabtink 


Description: [sem Normal 


Figure 3-6. Description field 


3.5.3 How to Configure Attributes/Connections 
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This section provides instructions for configuring an object attribute or connection. The 
procedure for selecting an attribute/connection is the same, whether you are selecting an 
attribute, single connection, or object connection. However, there is a different configuration 
procedure for each case. These procedures are referenced in step 3 below. 
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Descriptions of the various attributes are provided in Section 2, How to Configure Object 
Execution. 


To configure an attribute/connection: 


1. Select a part from the Parts column. 
The attributes/connections for the selected part are listed in the Attributes/Connections 
column, Figure 3-7. 
Parts Attributes/Connections | attripute: USE_SAME_ENGINE_AS 


[ALL] 


LINK_DEFINITION 
MATRIX_DEFINITION 
SYNCHRONIZATION 
FLOAT_INPUT 
DAT_BOOLEAN_INPUT 
DAT_REAL_OUTPUT 
DAT_BOOLEAN_OUTPUT 


USE_SAME ENGINE AS 
STARTUP_COMMAND 
PATH 


WORKING_DIRECTORY 


Figure 3-7. Attributes/Connections for the ENGINE_STARTUP part. 


NOTE 
[ALL] is the Parts list default. This displays all attributes and connections for all 
parts. After you select a specific part, you can return to the complete list by 
clicking [ALL]. 
Select an attribute or connection from the Attributes/Connections column. 


This changes the area to the right of the scrolled Attributes/Connections list according to 
the type of attribute/connection selected. This area will display a dialog for either 
Attribute, Single Connection, or Object Connection. 


Define the Attrbute, Single Connection or Object Connection using the appropriate dialog 
as described in: 


— Section 3.5.3.1, Attribute Configuration Dialog. 
- Section 3.5.3.2, Single Connection Configuration Dialog. 
— Section 3.5.3.3, Object Connection Dialog. 


Repeat steps 2 and 3 to configure the other attributes or connections for the selected part. 
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3.5.3.1 Attribute Configuration Dialog 


The Attribute Configuration Dialog, Figure 3-8, is displayed when you select an attribute from 
the Attributes/Connections scroll box. 


Attribute: USE_SAME_ENGINE_AS 


Figure 3-8. The Attribute Configuration Dialog. 


The attribute name is indicated in the Attribute field. The current value is always displayed in 
the unlabeled edit box below the Attribute field. You can enter a new value in this box if 
necessary. 


Click <OK> to accept and verify a new entry, or click <Cancel> to delete the new value and 
retrieve the attribute’s currently stored value. 


NOTE 


After you change an attribute value, if you select another attribute/connection 
without first clicking OK, a Save dialog is displayed. This dialog prompts you to 
confirm whether or not you want to save the changes you have made. Refer to 
Section 3.5.4, How to Save an Object Configuration for details. 


3.5.3.2 Single Connection Configuration Dialog 
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A single connection is a connection to any attribute of a specific object instance. The object 
instance and attribute are selected at configuration using the Single Connection dialog, 

Figure 3-9. You can alternatively specify a constant value to use as replacement. If the single 
connection is optional (as indicated by the word Optional in the top line), you may choose not to 
configure it at all. 
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Single Connection (Optional) (Float) input 


@ Not Configured 


& Object Connection 


IB Suppress error actions 


[ok] [Cancel| [Help| 


Figure 3-9. Single Connection Configuration Dialog. 


The purpose and operation of the fields and buttons in this dialog are described below: 


Top Line 


Radio Buttons: 

- Not Configured 

- Constant Value 

- Object Connection 


Constant Value Field 


Name 


Attribute 


Suppress Error Actions 
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The top line indicates the data type and direction of the connection. 
For instance, in Figure 3-9, the data type is Float, and the direction is 
Input. If this line has the word optional (as shown in Figure 3-9), you 
have the option of either configuring or not configuring this connection. 


Click Not Configured if the top line indicates that this is an optional 
connection, and you choose to Not Configure. 


Click on Constant Value and enter the value in the corresponding 
field if you want to use a constant value rather than an attribute. 


To configure a connection, click on Object Connection, then enter 
the object name and attribute in their respective fields. See How to 
Configure the Object Connection. 


If you clicked on the Constant Value radio button, enter the 
corresponding value in this field. 


The current value is always displayed. For new objects, the field is 
blank or set to the default given at object type design. If you enter a 
new value, it is checked. 


If you clicked on the Object Connection radio button, enter the name 
of the object instance in this field. See How to Configure the Object 
Connection. 


If you clicked on the Object Connection radio button, enter the name 
of the object attribute in this field. See How to Configure the Object 
Connection. 


Click on the Suppress error actions radio button to turn the 
suppression flag on or off. Suppression affects the object’s error- 
handling for reading connected object values. If reading a connection 
fails and error actions are not suppressed, the current object 
execution is terminated and the object’s error status is set to true. If 
suppression is on, the object execution is continued. 
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OK See Section 3.5.1, Object Configuration Window Overview. 
Cancel See Section 3.5.1, Object Configuration Window Overview. 
Help See Section 3.5.1, Object Configuration Window Overview. 
How to Configure the Object Connection 


To configure an object connection: 


1. 
2. 


Click on the Object Connection radio button. 
Enter an object name in the Name field, then press <Enter>. 


This fetches a list of attributes matching the connections data type. The first attribute is 
displayed in the Attribute: field. If no attribute matches the data type, the object name is 
not accepted. 


If you need to select a different attribute, click on the Attribute field. 


This displays a list of attributes for the specified object, Figure 3-10. 


Figure 3-10. Example, Attribute List. 


Click on any attribute in the list, and press <ENTER>, to select it. 
To close the list without making a new selection, click on Cancel. 


Click <OK> in the Single Connection dialog to accept and verify the new configuration, 
or click <Cancel> to delete the new configuration and retrieve the connection’s currently 
stored configuration. 
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NOTE 


After you make any changes to the connection configuration, if you select another 
attribute/connection without first clicking OK, a Save dialog is displayed. This 
dialog prompts you to confirm whether or not you want to save the changes you 
have made. Refer to Section 3.5.4, How to Save an Object Configuration for 
details. 


3.5.3.3 Object Connection Dialog 


An object connection is a connection to a specified object type. Only objects of that object type 
can be configured to that connection. The object instance is selected at configuration using the 
Object Connection Dialog, Figure 3-11. If the object connection is optional (as indicated by the 
word Optional in the top line), you may choose not to configure it at all. Also, by selecting the 
trigger function, you can specify that the object you configure will be activated when the 
connected object generates a specific event. 


Object Connection (Optional) input 
© Not Configured 
@ Object Connection (DAT) 


[= Suppress error actions 


Cl Trigger | | 
| 


Figure 3-11. The Object Connection Dialog 


The purpose and operation of the fields and buttons in this dialog are described below: 


Top Line The top line indicates the direction of the connection. For instance, in 
Figure 3-11, the direction is Input. If this line has the word optional, 
you have the option of either configuring or not configuring this 
connection. 


Radio Buttons: Click Not Configured if the top line indicates that this is an optional 


- Not Configured connection, and you choose NOT to configure. 


To configure a connection, click on Object Connection, then enter 


- Object Connection ; 4 : 
the object name in the Name field. 
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Name If you clicked on the Object Connection radio button, enter the name 
of the object instance in this field. If the object is of the correct type, it 
is accepted. If it is not accepted, or if it does not exist, an error 
message box is displayed. 


The object type of the currently selected object connection is indicated 
at the right of the radio button text Object Connection. For instance, 
in Figure 3-11, the object type is DAT. 


Suppress error actions Click on the Suppress error actions radio button to turn the 
suppression flag on or off. This function is only valid for input 
connections. 


Suppression affects the object’s error-handling for reading connected 
object values. If reading a connection fails and error actions are not 
suppressed, the current object execution is terminated and the 
object’s error status is set to true. If suppression is on, the object 
execution is continued. 


Trigger Can not be used for this object type. 

Event Name Not relevant. 

OK See Section 3.5.1, Object Configuration Window Overview. 
Cancel See Section 3.5.1, Object Configuration Window Overview. 
Help See Section 3.5.1, Object Configuration Window Overview. 


When you are finished with the dialog, click <OK> to accept and verify the new configuration, 
or click <Cancel> to delete the new configuration and retrieve the connection’s currently stored 
configuration. 


3.5.4 How to Save an Object Configuration 


You must save any changes to the object you are currently configuring before you can select 
another object to edit, or begin configuring a new object. To save the configuration for the 
object you are currentlty editing, choose Save from the File menu. 


If the object is not authorized for write access, Save is dimmed in the File menu and cannot be 
chosen. See Section 3.5.2.1, Authorization for further information. 


NOTE 


An error message is generated if all compulsory attributes and connections are not 
properly configured when you attempt to save. If these attributes and connections 
are not correctly configured, the object is not saved. 


The Modified Object dialog box, Figure 3-12, is displayed when you modify an object 
configuration and you do either one of the following without first saving the changes: 


° Choose New or Exit from the File menu. 


° Select another object type or object name from the Object selection box. 
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This dialog box prompts you to confirm whether or not you want to ignore the changes you have 
just made. Click Yes to ignore all changes (not save), or click on No to save the changes. 


You can press <ENTER> to select the default action. The default action is indicated with a 
double frame, and depends on the action selected the last time the dialog box was displayed. In 
Figure 3-12 the default action is Yes. 


Modified Object 


@ Object is modified. Ignore changes ? 


Figure 3-12. The Modified Object dialog box. 


3.5.5 Help Message Box 


Choose any of the Help items from the Help menu for general Help. For specific Help with any 
of the dialog boxes, click on the Help button in the dialog box. Help is always displayed in a 
Help window, Figure 3-13. 


Help On Index 
The help on index gives the ability to step through the valid indexes. 


References to connected help entries appear at the bottom of the Help 
box. If you double click on one of them, information for that item 
appears. 


Object Selection Box 
New Object Dialog 
Copy Object Dialog 


Figure 3-13. The Index Help window 


The help window displays help text on the selected subject. The help windows file menu 
contains two items, Keep text and Close. Keep text is a toggle that, when set, specifies that the 


3-20 3BSE 013 989R0001 


AdvaTalk® Link to MATLAB® User’s Guide 
Section 3.5.6 How to Configure Object Execution 


text in the window should not be changed when help is requested again (that is a new help 
window is opened). Close closes the help window. 


If there are indices (references) to other help texts, those are displayed in the bottom of the help 
window as shown in Figure 3-13. By double clicking on such a reference that help text will be 
presented. The previous index is displayed in the index area when the new text is presented. 
By double clicking on it you return to the first text. This way you can step through the help text 
hierarchy. 


3.5.6 How to Configure Object Execution 
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You can configure execution for an object using either one of the following methods: 
° Cyclic execution. 

This means there is a fixed time between each execution. 
° Scheduled execution. 


This means execution at specific times. For example, 12 o’clock the last day of each 
month, January to October. 


This is done via the Execution Configuration dialog box, Figure 3-14. The Object Configuration 
tool is locked as long as this dialog box is active. 


I= Scheduled Execution Enabled 


| MAR-APR,AUG,NOV Modify | 
Day | MON-FRI,1,15,LAST. Modify | 
Hour | 6-7,14,22 Modify | 


Minute | 15 Modify | 
Second Modify | 


©) Cyclic Execution Enabled 


interval E | seconds 


Figure 3-14, Execution Configuration dialog. 
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Scheduled Execution 


You can specify execution in almost any combination of execution intervals. In the example 
shown in Figure 3-14, the execution takes place during March, April, August and November on 
Mondays through Fridays as well as on the Ist, the 15th and the last day of each month 
specified. 


Execution takes place four times during each of these days (at 6:15, 7:15, 14:15 and 22:15). 
The execution will be repeated once, with a delay of 30 seconds for the second execution. 
This execution time is used as an example to illustrate the following step-by-step procedure. 


1. 


Choose Execute from the File menu. 
This displays the Execution Configuration dialog box. 
Make sure the Sceduled Execution Enabled button is selected (filled black). 


The interval that you configure are valid only if the Sceduled Execution Enabled field is 
set to on. A new object is disabled by default. 


Specify the year(s) for sceduled execution. 


Enter the year in the Year field as a text string. The text string’s format is YYYY. For 
example: 1993. You can also use the asterisk (*) which stands for every year. 


Specify the month(s) for sceduled execution. 


You can either enter the month(s) directly in the Month field, or click on the Modify 
button next to the Month field to display the Month dialog box. 


If you enter the month(s) directly, use the following text format: 


* 


Use the asterisk to specify execution takes place every month. 
MMM,MMM One or several months are specified in a list. For example: JAN,NOV 
MMM-MMM A sequence of months are specified. For example: JAN-APR 


To use the Month configuration dialog box: 
a. Click on <Modify> next to the Month field. 


This displays the Month Configuration dialog box, Figure 3-15. 
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S|January © July 
Cl) February M# August 
I= March ©) September 


I April ©) October 


©) June ©) December 
[Cancel | Help | 


Figure 3-15. Month Configuration dialog box. 


b. Select any combination of months by clicking on their respective buttons, or select all 
months by clicking on All. To clear (de-select) all selected months, click on None. 


c. When you are finished selecting the months click OK to accept your selection, or 
Cancel to remove the dialog box without modifying the month selection (what ever 
the configuration was before you opened the dialog box. 


Specify the day(s) for sceduled execution. 


You can either enter the day(s) directly in the Day field, or click on the Modify button next 
to the Day field to display the Day dialog box. 


If you enter the day(s) directly, use the following text format: 


a. Use the following text format for weekdays (Monday - Sunday): 


* Use the asterisk to specify execution takes place every day. 
DDD,DDD One or several days are specified in a list. For example: MON, TUE 
DDD-DDD A sequence of weekdays. For example: MON-FRI 


b. Use the following text format for dates (1-31) of the month: 


i Use the asterisk to specify execution takes place every day. 

NN,NN One or several days of the month (numbers 1 - 31) are specified ina 
list. For example: 1,5,30 

NN-NN A sequence of days of the month is specified. For example: 1-5 

Last Enter Last for the last day of the month. 
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To use the Day Configuration dialog box: 
a. Click on <Modify> next to the Day field. 
This displays the Day Configuration dialog box, Figure 3-16. 


Day 
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Figure 3-16. Day Configuration dialog box. 


b. Select any combination of weekdays (Monday-Sunday) by clicking on their 
respective buttons, or select all weekdays by clicking on All. To clear (de-select) all 
selected weekdays click on None. 


c. Select any combination of days of the month (1-31, Last) by clicking on their 
respective buttons, or select all days of the month by clicking on All. You can use the 


Last button to select the last day of the month. To clear (de-select) all selected days 
of the month click on None. 


d. When you are finished selecting the days click OK to accept your selection, or 
Cancel to remove the dialog box without modifying the day selection (what ever the 
configuration was before you opened the dialog box. 


6. Specify the hour(s) for sceduled execution. 


You can either enter the hour(s) directly in the Hour field, or click on the Modify button 
next to the Hour field to display the Hour Configuration dialog box. 
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If you enter the hour(s) directly, use the following text format: 


. Use the asterisk to specify execution takes place every hour. 


HH,HH One or several hours (0 - 23) are specified in a list. 
For example: 7,18,23 


HH-HH A sequence of hours is specified. For Example: 7-9 


To use the Hour Configuration dialog box: 
a. Click on <Modify> next to the Hour field. 
This displays the Hour Configuration dialog box, Figure 3-17. 
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Figure 3-17. Hour Configuration dialog box. 
b. Select any combination of hours by clicking on their respective buttons, or select all 
hours by clicking on All. To clear (de-select) all selected hours click on None. 


c. When you are finished selecting the hours, click OK to accept your selection, or 
Cancel to remove the dialog box without modifying the hour selection (what ever the 
configuration was before you opened the dialog box. 


7. Specify the minute(s) for sceduled execution. 


You can either enter the minute(s) directly in the Minute field, or click on the Modify 
button next to the Minute field to display the Minute Configuration dialog box. 


If you enter the minute(s) directly, use the following text format: 


is Use the asterisk to specify execution takes place every minute. 


MM,MM One or several minutes(0 - 59) are specified in a list. 
For example: 15,30,45 


MM-MM A sequence of minutes is specified. For Example: 0-15 
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To use the Minute Configuration dialog box: 
a. Click on <Modify> next to the Minute field. 
This displays the Minute Configuration dialog box, Figure 3-18. 
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Figure 3-18. Minute Configuration dialog box. 


b. Select any combination of minutes by clicking on their respective buttons, or select 
all minutes by clicking on All. To clear (de-select) all selected minutes, click on 
None. 


c. When you are finished selecting the minutes, click OK to accept your selection, or 
Cancel to remove the dialog box without modifying the minute selection (what ever 
the configuration was before you opened the dialog box. 


8. Specify the second(s) for sceduled execution. 


You can either enter the second(s) directly in the Second field, or click on the Modify 
button next to the Second field to display the Second Configuration dialog box. 


If you enter the second(s) directly, use the following text format: 


Use the asterisk to specify execution takes place every second. 


SS,SS One or several seconds(0 - 59) are specified in a list. 
For example: 15,30,45 


SS-SS A sequence of seconds is specified. For Example: 0-15 
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To use the Second Configuration dialog box: 
a. Click on <Modify> next to the Second field. 


This displays the Second Configuration dialog box, 


21 20 [i 30] 21 40 
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Figure 3-19. Second Configuration dialog box. 
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Cyclic Execution 


The cyclic interval is specified in seconds. This is a fast and convenient way to configure a 
cyclic execution. You can use it when the repetition interval is important, not execution at 
specific times. The execution is aligned to the last execution time and not to a schedule. 


In the example in Figure 3-20 the object is executed every seventh second. This execution time 
is used as an example to illustrate the following step-by-step procedure. 


Year 


Month 


Day 


Hour 


Minute 


Second 


Interval 


Figure 3-20. Cyclic Execution selected. 


1. Choose Execute from the File menu. 


This displays the Execution Configuration dialog box. 


2. Make sure the Cyclic Execution Enabled button is selected (filled black). The interval that 


you configure are valid only if the Cyclic Execution Enabled field is set to on. 


3. Enter the interval in the input field. 
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3.5.7 Description of Attributes/Connections 


3.5.7.1 Attributes for ENGINE STARTUP 


USE_SAME_ENGINE_AS 


If more than one instance of the MatlabLink object type share the same MATLAB process, one 
of the instances is considered as the “root” instance. For the root instance, 
USE_SAME_ENGINE_AS must be undefined (empty). For all other instances, 
USE_SAME_ENGINE_AS must be defined as the name of the root instance. 


STARTUP_COMMAND 


For this attribute, enter the command to start a MATLAB process. Three senarios are possible: 
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To start a MATLAB process on the current machine and display, simply enter the startup 
command. 


To start a MATLAB process on the current machine, but on another display, use the export 
DISPLAY command with the startup command: 


ksh -c ‘export DISPLAY=<tcp/ip no>:0;<MATLAB start-up 
command>’ 


where <tcp/ip no> is the tcp/ip number of the display. 


To start a MATLAB process on another machine and a display on the current machine, 
enter the remote host and use the export DISPLAY command with the startup command: 


remsh <remote host> ‘export DISPLAY=<tcp/ip no>:0;<MATLAB 
start-up command>’ 


where <remote host> is the tcp/ip number of the remote host and <tcp/ip no> is the 
tcp/ip number of the display. 


The remote host is called with the same user as on the current machine. If that user 
also exists on the remote host, only the file /etc/hosts.equiv has to be edited on the 
remote host. The tcp/ip number of the current machine has to be added. 


If the user doesn’t exist, the file .rhosts in the login directory has to be edited on the 
remote host. The user of the current machine has to be added. 


NOTE 


In all three cases, it is very important to give the correct start-up command. 
Otherwise a process with the name <defunct> will be created. This process has 
lost the contact with its mother, the object handler. The only way to kill such a 
process is to kill its mother. If you send a kill signal on the object handler it will 
be automatically restarted. Please note that if there are any connected MATLAB 
processes they will also be restarted and the workspace data will therefore be lost. 
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PATH 


This path is added to the MATLAB environment variable MATLABPATH when the MATLAB 
process is started. The script file to be executed by the instance will reside in this directory. 


WORKING_DIRECTORY 
This is the Home directory of the MATLAB process. 


3.5.7.2 Attributes for LINK_DEFINITION 
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MATLAB_COMMAND 


This is the name of the MATLAB script or command to be executed. The .m suffix is not 
included in the name. If the script does not reside in the same directory as the PATH attribute 
has been configured to, the MATLAB_COMMAND attribute must be defined as the entire path 
plus the script name. 


HEADER_ID 


This is a user-defined number to uniquely identify each of two input vectors that use the same 
input vector name. This ID number can be used in the MATLAB script as a switch value. Valid 
numbers are 0 to 100. 


USE_SEND_EVENT 


If the current instance shall be able to trigger another instance configure this attribute to true, 
otherwise false. 


When this attribute is configured to true and the USE_SCRIPT_EVENT attribute is configured 
to false, the instance is generating an event each time it is executed. The event is called 
MATLABLINK_EVENT. 


If the USE_SCRIPT_EVENT attribute also is configured to true, it is bit 34 in the output 
vector that decides whether the event shall be generated or not. If the bit is set an event is 
generated. Section A.1.2, Output Vector Organization and Figure A-2 refers. 


USE_SCRIPT_EVENT 


If the triggering is to be controlled from the executed MATLAB script, configure this attribute 
as true, otherwise false. 


USE_RETURN_CODE 


It is possible to distribute a return code from the executed MATLAB script to the instance. If 
USE_RETURN_CODE is set to true the instance will generate different system messages, 
depending on the value of the the return code. If the code is less then zero, a script error is 
generated. If the code is zero or greater, a script warning is generated at each execution. 
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RETURN_CODE 
This is the return code from the MATLAB script. This attribute can be read via SQL-Plus. 


BAD_DATA_LIMIT 


This specifies the number of consecutive read failures that are allowed before a system message 
is generated and the status bit INPUT SIGNAL ERROR is set. Valid numbers are 0 to 20. 


CURRENT_BAD_DATA 


This is the current number of consecutive read failures. This attribute can be read via SQL-Plus. 


3.5.7.3 Attributes for MATRIX_DEFINITION 


INPUT_VECTOR_NAME 


This is the name of the input vector to be used in the executed MATLAB script. The vector is 
copied from the MatlabLink instance to the MATLAB process. The vector format is described 
in Section A.1.1, Input Vector Organization and Figure A-1. 


OUTPUT_VECTOR_NAME 


This is the name of the output vector to be used in the executed MATLAB script. The vector is 
copied from the MATLAB process to the MatlabLink instance. The vector format is described 
in Section A.1.2, Output Vector Organization and Figure A-2. 


DEFAULT_FLOAT 


The float values of the input vector is initialized with this value. 


DEFAULT_BOOLEAN 


The boolean values of the input vector is initialized with this value. 


3.5.7.4 Attributes for SYNCHRONIZATION 


TRIGGER_SIGNAL 


If this instance is to be triggered by another instance, configure TRIGGER_SIGNAL as the 
name of the triggering instance. Remember to set USE_LSEND_EVENT to TRUE to enable the 
event generation for that instance. 


3.5.7.5 FLOAT_INPUT Connections 


Contains single connections that can be connected towards objects with attributes of the type 
float. 
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3.5.7.6 Boolean Input Connections 


MOD 300 


The part BOOLEAN_INPUT contains single connections that can be connected towards objects 
with attributes of the type float. The value read is interpreted as zero (0) if the attribute value is 
less than one. Otherwise it is interpreted as one (1). 


Master 


The part DAT_BOOLEAN_INPUT contains object connections that can be connected towards 
objects of the DAT type. It is the first bit in the IL_VAL attribute that is read (BO_VAL). 


3.5.7.7 Real Output Connections 


MOD 300 


The part DATA_FCM_REAL_OUT contains object connections that can be connected towards 
objects of the DATA_FCM type. It is the attribute DATA that is updated. 


Master 


The part DAT_REAL_OUTPUT contains object connections that can be connected towards 
objects of the DAT type with the VAL_TYPE attribute set to 4 (real). It is the attribute R_VAL 
that is updated. 


3.5.7.8 Boolean Output Connections 


MOD 300 


The part DATA_FCM_BOOL_OUT contains object connections that can be connected towards 
objects of the DATA_FCM type. It is the attribute DATA that is updated with either the value 0 
or the value 1. 


Master 


The part DAT_REAL_OUTPUT contains object connections that can be connected towards 
objects of the DAT type with the VAL_TYPE attribute set to | (boolean). It is the attribute 
BO_VAL that is updated. 


3.6 Configuration/Application Building Menus 
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This section describes each menu regarding text fields, push-buttons, restrictions (if any), 
ranges and rules for data and all other issues of interest. 


This section provides quick help for experienced users who may already be familiar with the 
Object Configuration tool, but may not remember a particular detail such as the operation of a 
specific menu item. 
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You can access New, Open, Save, Copy, Execute, Delete and Exit functions from the File 
menu, Figure 3-21. Each option is described in detail in the following sections. 


3.6.1.1 File - New 


Figure 3-21. File Menu 


Open... 


Save 


Copy 


eXecute 


Delete 


Exit 


Use the New menu item to create an object of a selected object type. The previously selected 
object must be saved before you can begin a new object. When you choose New from the File 


menu the New Name dialog box is displayed, Figure 3-22. 
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New object name 
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Cancel 


Help 


Figure 3-22. New Name Dialog Box 


The purpose and operation of the fields and buttons in this dialog box are described below: 


New object name Enter the new object name in the New object name field. The object 
name must follow certain rules. It must alsobe unique within the node. 


OK Click on OK to accept the object name after you enter it in the New 
object name field. 


3BSE 013 989R0001 


3-33 


AdvaTalk® Link to MATLAB® User’s Guide 
Chapter 3 Configuration/Application Building 


3.6.1.2 File - Open 
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Cancel Click on Cancel to remove the dialog box without creating a new 
object. 
Help Click on Help to get Help information about this dialog box. 


After you enter the object name and it is accepted as legal, the new object is created. All 
attributes are given default values for the object type. The first available Normal Operation is 
selected. Cyclic execution is made inactive. The new object is displayed by default, and the first 
attribute in the attribute list is selected and displayed. 


Use the Open menu item to select an existing object to work with. When you choose Open 
from the File menu an Open Object dialog box is displayed, Figure 3-23. This dialog box 
provides the means to select a specific object instance. 


Select an object instance from the list of objects in the right selection box. 


MatlabLink 
Valvel 
Valve2 


Selection 


Figure 3-23. Open Object Dialog Box 
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The purpose and operation of the fields and buttons in this dialog box are described below: 


Object Types The selection box on the left side of the dialog box lists the available 
object types. 
Objects The selection box on the right side of the dialog box lists the available 


object instances for the selected object type. 


Selection This field indicates the selected object instance. If you know the name 
of the object instance you want to open, you can enter it directly in this 
field rather than select the object type and then object instance from 
the selection boxes. 


OK Click on OK to open the selected object instance and then remove the 
dialog box. 

Apply Click on Apply to open the selected object instance and keep the 
dialog box open. 

Cancel Click on Cancel to remove the dialog box without opening a new 
object. 

Help Click on Help to get Help information about this dialog box. 

NOTE 


The configuration tool works locally in the node where it executes, so you can 
only use it to display and configure objects and object types residing in that node. 
The objects specified in the connections, however, may reside anywhere in the 
entire system. 


3.6.1.3 File - Save 


Choose Save from the File menu to save the currently selected object. 
If the object is not authorized for write access, Save is dimmed in the File menu and cannot be 
chosen. See Section 3.5.2.1, Authorization, for further information. 

NOTE 


An error message is generated if all compulsory attributes and connections are not 
properly configured when you attempt to save. If these attributes and connections 
are not correctly configured, the object is not saved. 


3.6.1.4 File - Copy 


Use the Copy menu item to copy an object into a new object instance of the same object type. If 
the current object has been modified since last saved, the object is saved with these 
modifications before copying is completed. 
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When you choose Copy from the File menu the Copy Name dialog box is dispayed, 


Figure 3-24. 
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Figure 3-24. Copy Name Dialog Box 


The purpose and operation of the fields and buttons in this dialog box are described below: 


New object name Enter the name of the new object instance in this field. 

OK Click on OK to make a duplicate copy of the currently selected object. 
The duplicate copy will have the name specified in the New object 
name field. 

Cancel Click on Cancel to remove the dialog box without making a copy of 


the selected object. 


Help Click on Help to get Help information about this dialog box. 


When the object name is accepted as legal (it must be unique within the node), the Copy action 
is performed and the new object is displayed. It is recommended that you modify the object 
description before saving it. The new object is copied in the same state as the original object. 


You must save the object with File-Save before you can start it. 
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NOTE 
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Use the Execute menu item to configure cyclic execution (if required). When you choose 
Execute from the File menu, the Execution Configuration dialog box is displayed, Figure 3-25. 


Year | * 
Month | MAR-APR,AUG,NOV 
Hour | 6-7,14,22 


Minute 


Second 


I= Scheduled Execution Enabled 


©) Cyclic Execution Enabled 


interval E | seconds 


Figure 3-25. Execution Configuration dialog. 


The purpose and operation of the fields and buttons in this dialog box are described below: 


Sceduled Execution 
Enabled 


Year 


Month 


Day 
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Use this button to enable or disable scheduled execution. The 
scheduled execution time configure are valid only if the Scheduled 
Execution Enabled field is set to on. A new object is disabled by 
default. 


Use this field to specify the year(s) for execution. Refer to Section 
3.5.6, How to Configure Object Execution for details. 


Use this field to specify the month(s) for execution. You can either 
enter the months directly in this field, or click on the corresponding 
Modify button to display the Month Configuration dialog box. Refer to 
Section 3.5.6, How to Configure Object Execution for details. 


Use this field to specify the day(s) for execution. You can either enter 
the days directly in this field, or click on the corresponding Modify 
button to display the Day Configuration dialog box. Refer to Section 
3.5.6, How to Configure Object Execution for details. 
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Hour 


Minute 


Seconds 


Modify 


Cyclic Execution 
Enabled 


Interval 
OK 


Cancel 


Help 


Use this field to specify the hour(s) for execution. You can either enter 
the hours directly in this field, or click on the corresponding Modify 
button to display the Hour Configuration dialog box. Refer to Section 
3.5.6, How to Configure Object Execution for details. 


Use this field to specify the minute(s) for execution. You can either 
enter the minutes directly in this field, or click on the corresponding 
Modify button to display the Minute Configuration dialog box. Refer to 
Section 3.5.6, How to Configure Object Execution for details. 


Use this field to specify the second(s) for execution. You can either 
enter the seconds directly in this field, or click on the corresponding 
Modify button to display the Second Configuration dialog box. Refer 
to Section 3.5.6, How to Configure Object Execution for details. 


To enter months, days, hours, and minutes via dialog box rather than 
directly in their respective fields, click on the corresponding Modify 
button to display the dialog box. 


Use this button to enable or disable cyclic execution. The cyclic 
execution interval that you configure are valid only if the Cyclic 
Execution Enabled field is set to on. A new object is disabled by 
default. 


Enter the interval in seconds. 
Click on OK to accept your entries. 


Click on Cancel to remove the dialog box without accepting new 
entries 


Click on Help to get Help information about this dialog box. 


When you use the Execution Configuration dialog box, the Object Configuration tool is locked. 


3.6.1.6 File - Delete 


Use the Delete menu item to remove all information about an object. When you choose Delete 
from the File menu, the Confirm delete dialog box is displayed with a prompt asking you if you 
are sure you want to delete, Figure 3-26. 
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=| Confirm delete 


Delete of object can not 
be undone! Do you want 


to continue? 


YES NO 


Figure 3-26. Confirm Delete Dialog Box 
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The purpose and operation of the fields and buttons in this dialog box are described below: 


YES Click on YES to confirm that you want to delete the object. 


NO Click on NO to cancel the Delete operation. 


3.6.1.7 File - Exit 


Choose Exit from the File menu to terminate the configuration tool. 


3.6.2 Help Menu 
The following options are available from the Help menu, Figure 3-27: 
° On Help 


Select On Help for information on how to use Help. 
* On Window 


Select On Window for information on the Object Configuration window. The File and 
Help menus and the OSF/Motif features related to a graphical display are described. 


° On Keys 
Select On Keys for information on how to use function keys, mnemonics and keyboard 
accelerators. 

° Index 


Select Index to view an index of all the Help information in the tool. 


° On Version 


Select On Version to determine the name and the version of the tool. 


° | 
Help 


On Help 


On Window 


On Keys 


Index 


On Version 


Figure 3-27. Help Menu 


Help information is displayed in a Help message box. You can request Help by either: 
° Selecting the Help menu, or 


° Clicking on Help buttons in the display dialog boxes. 
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Chapter 4 Runtime Operation 


4.1 Product Operation 
You can present the AdvaTalk Link to MATLAB and the MATLAB software on: 
° an X-terminal connected to an IMS via the TCP/IP protocol 
° an Operator Station connected to the IMS via the TCP/IP protocol 


The Advalnform Basic Functions User’s Guide (Chapter 3) describes how to configure an 
Advant Station 500 Series OS to open a window towards an IMS. 


° the IMS console terminal 


° a PC or Apple - Macintosh computer with X emulation software 


4.2 Operating Overview 


4.2.1 Operating the Off-line Interface 


Each off-line function, is described in detail in Appendix A, References, Section A.3, Off-line 
Functionality. To invoke an off-line function: 


1. Start the MATLAB window by choosing Link to MATLAB from the AdvaInform menu, 
and then choosing MATLAB from the sub-menu. 


2. Enable the off-line interface by entering off-line at the MATLAB prompt. 
a. If you want to display a list of the available functions enter: 
>> help ocsfunc 
Help is available for each function. 
b. If you need help for a specific function, enter: 
>> help <function> 
where <function> is the name of the function. 
3. Invoke an off-line function at the MATLAB prompt. For example: 


>> resolveObj(‘AI_1’) 
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4.2.2 Operating the On-line Interface 


The configured MatlabLink object instances are operated (activated/deactivated) from the Link 
to MATLAB Configuration tool or an AdvaInform User API interface application program. The 
tool is started from the IMS main menu by choosing Link to MATLAB from the AdvaInform 
menu, and then choosing Configuration from the sub-menu. 


To activate an instance, push the Start button. To deactivate an instance, push the Stop button. 
STATUS BITS 


The MatlabLink object type has an attribute called STATUS which has seven status bits 
implemented. These are: 


(1) active is set when the object is activated/started. 
(2) error is set as soon as a fatal error in the object’s execution takes place. 
(3) updated is set as soon as the object has executed once after activation/system start-up. 


(4) input signal error is set when the number of consecutive read errors from the input 
connections has exceeded the value in the attribute BAD DATA LIMIT. 


(5) output signal error is set when the return matrix from the MATLAB workspace has 
wrong dimension or if some of the values in the matrix is not finite. 


(6) script error is set when a error in the executing MATLAB script is detected. 


(7) engine error is set when the connection between the MatlabLink instance and the 
MATLAB process is interrupted. 


4.2.3 Operating using Advalnform Basic Functions 


AdvalInform Basic functions provides the following ways to operate on MatlabLink objects: 
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SQL*PLUS 


To start SQL*PLUS, choose Database Access from the Station menu in the IMS main 
menu. From SQL*PLUS, you have read access to all MatlabLink attributes in the 
MatlabLink object instance table, co_matlablink_inst, if you use the database user 
ims_user. You have also read access to the matrix tables, matrix and matrix_values, where 
the off-line function storeMatrix stores matrix data from MATLAB workspace. 


Embedded SQL 


Embedded SQL requires the Programmer 2000 Pro*C license. Through Embedded SQL, 
you can write application programs that read data from the MatlabLink object attributes in 
the same way as SQL*PLUS. 


User API programming library 


Using the User API programming library, you can write application programs that can read 
and operate on MatlabLink objects. 
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4.3 Runtime Tutorial 


This section is not applicable. 


4.4 Operating Instructions 


This section is not applicable. 


4.5 Runtime Operation Menus 


This section is not applicable. 
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Chapter 5 Maintenance 


5.1 Preventive Maintenance 


The AdvalInform Basic Functions contains functionality for backup and restore on two levels: 
full or incremental. 


Full Backup and Full restore 


Full Backup makes a complete backup of the IMS disks and the Full Restore function restores 
them. The Full Backup and Restore functions require that IMS be shut down. 


Incremental Backup and Incremental Restore 


The Incremental Backup saves the current system configuration and stores the database backup 
and all other modified disk files on a selected set of directories on DAT tape. 


By complementing the Full Backup with a repeated Incremental Backup, your installation and 
configuration and application data are secured. The restore function restores all files that do no 
longer exist on the system. It does not overwrite files with the same or newer time stamp as in 
the backup. 


In chapter 5 of the Advant Station 500 Series IMS User’s Guide you can find information about 
the Station Backup and Restore feature included in AdvaInform Basic Functions. 


5.2 Hardware Indicators 
Not applicable. 


5.3 Error Messages 


Error messages are sent from the Link to MATLAB whenever access to the User API, the 
Oracle database or the MATLAB engine fails. The error message will always contain a System- 
, API- or Oracle error message. This message contains all vital information necessary to track 
down the problem. The severity level of this message is either Error or Warning. 


If you are going to analyze the error messages, please identify the error codes/message sent 
from either the User API, the Oracle database or the operating system. A message from Oracle 
is self-explanatory whereas messages from the User API or the operating system requires 
further interpretation. In order to get cause and action for an error message from Oracle, simply 
use the tool oerr. 
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Information on operating system errors can be obtained using the man-pages for individual 
services (error names and numbers are found in the file /usr/include/sys/errno.h). Finally, 

information on errors that emanate from the User API is found in the Advalnform User API 
User’s Guide. 


The system messages issued by the AdvaTalk Link to MATLAB on-line interface will be sent to 
the System Messages display. 


The system messages issued by the off-line interface is sent to the current MATLAB window. 


They have the following standardized format: 


Error string <P1><P2><P3> 


Parameters: 


Audience: 


Cause: 


Action: 


P1: description of parameter 1 

P2: description of parameter 2 

P3: description of parameter 3 

The parameters are optional in an error message. This means that there might 
be no parameter, just a text, or one, two or three parameters. 


The audience of the error message. Valid entries are Operator, Engineer, 
Service and Debug. 


Cause of the error. 


Action to take when the error occurs. 


The error messages are sorted after their severity in the following classes: 


Fatal error messages 


Error messages 


Warning messages 


Information messages. 


Example: 


OMF error during Server access, (errno = <P1>) 


Parameters: 
Audience: 


Cause: 


Action: 


P1: OMF return status 
Engineer 


An OMF error occurred when the SQL*Connect Server was accessed from a 
client. 


Check for error logs from OMF and if the omfPM process is running. If not 
running, restart IMS. 
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5.3.1.1 Fatal Error Messages 
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Configuration error: Symbol Resolve Error <P1> 


Parameters: P1: Object Name 


Audience: Engineer 
Cause: The connected object does not exist any more. 
Action: Reconfigure the connection to a valid object. 


Object error: Instance table error <P1> 


Parameters: P1: Name of the object for which the error occurred. 


Audience: Service 
Cause: Error when accessing the instance table. 
Action: Try to start the object once more. If the error still occurs, contact your nearest 


Local ABB Support Office. 


Object error: OMF bind error <P1> 

Parameters: P1: Name of the object for which the error occurred. 
Audience: Service 

Cause: Internal core system error. Can affect future execution. 


Action: Contact your nearest Local ABB Support Office. 
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Object error: Runtime error in operation <P1> 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer, Service 


A run time error in the object execution occurred, for example, an instance has 
failed to establish a connection to MATLAB. The object status bit error (bit 2) is 
set and the object is stopped. 


If this error occurs together with a instance start-up failure error, there is 
probably an error in the start-up command attribute. Then the object must be 
reconfigured to run again. Otherwise, it probably is an error in the object type 
implementation, report the error t your nearest Local ABB Support Office. 


Object error: Reduce group error <P1> 


Parameters: 
Audience: 
Cause: 


Action: 


5.3.1.2 Error messages 


P1: Name of the object for which the error occurred. 
Service 
Internal core system error. Can affect future execution. 


Contact your nearest Local ABB Support Office. 


<P1> Error in input signal to MATLAB 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer 


The number of consecutive read errors of the configured input connections 
have exceeded the value in the bad data limit attrioute. This probably depends 
on high load in the IMS or in the connected network. 


Contact the system responsible. 
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<P1> Error in output signal from MATLAB 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer 


The output vector from MATLAB has wrong dimension or at least one value in 
the output vector is not finite. 


Correct the script. 


<P1> Instance start-up failure 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator; Engineer 


Internal error when trying to establish a connection to an already started 
MATLAB process. This error should not occur. 


Try to start the object once more. If the error still occurs, contact your nearest 
Local ABB Support Office. 


<P1> Instance start-up failure - Failed to establish a connection to MATLAB 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer 


Error when trying to establish a new connection to MATLAB. Either the start-up 
command attribute needs to be reconfigured, or else you have run out of 
available MATLAB licenses. 


Reconfigure the start-up command attribute or stop an active MATLAB process 
and try to start the object again. 
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<P1> MATLAB script runtime error 
Parameters: P1: Name of the object for which the error occurred. 
Audience: Engineer 


Cause: 1. Error in the executed MATLAB script. 
2. The configured script does not exist. 
3. The script return code in the output vector is less than zero (and the use 
return code attribute is configured to true). 
Action: 1. Correct the script. 
2. Obvious. 
3. No action. 


Connection error: Bad object reference <P1> <P2> 


Parameters: P1: Name of the object for which the error occurred. 
P2: Reference of the object for which the error occurred. 


Audience: Engineer 
Cause: The connected object does not exist anymore. 
Action: Reconfigure the connection to a valid object. 


Error: No more free memory 


Parameters: 

Audience: Engineer 

Cause: No more free memory in the machine. No more room to create new objects. 
Action: Delete a few objects handled by the specific object handler. If it is a Advant 


Station 500, extend the UNIX kernel to accommodate larger programs. 
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Object error: Already active error <P1> 
Parameters: P1: Name of the object for which the error occurred. 
Audience: Engineer 


Cause: Attempt to start an already started object. Probably two applications that 
collide, one trying to activate an already active object. 


Action: Perform an investigation which applications that access the object in question. 
Try to find out which applications that interfere with one another. 


Object error: Connection read error <P1> 


Parameters: P1: Name of the object for which the error occurred. 


Audience: Engineer 
Cause: The connected object does not exist anymore. 
Action: Reconfigure the connection to a valid object. 


Object error: Cyclic Normal Operation error <P1> 


Parameters: P1: Name of the object for which the error occurred. 


Audience: Engineer, Service 
Cause: The cyclic operation resulted in a fatal error. 
Action: Check for additional system messages for more information on the fault. 


Reconfigure the object if that corrects the error. Otherwise, contact your 
nearest Local ABB Support Office. 


Object error: Cyclic overflow error <P1> 
Parameters: P1: Name of the object for which the error occurred. 
Audience: Operator, Engineer 


Cause: Cyclic normal operation overflow error. This means that the previous execution 
is not completed when a new request for cyclic execution is issued. 


Action: Reconfigure the execution schedule. Raising the object handler priority (use 
the Object Type Builder) or lowering the priority of other programs may also 
solve the problem. 
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Object error: Trigged Normal Operation error <P1> 


Parameters: P1: Name of the object for which the error occurred. 


Audience: Engineer 
Cause: 1. A triggered (event driven) execution of the Normal Operation resulted in a 
error. 


2. A instance that shall be triggered by another instance has been started 
before the instance that shall send the trigger event. 


Action: 1. Check for additional system messages for more information on the fault. 
Reconfigure the object if that corrects the error. Otherwise contact ABB. 


2. No action. 


Previous Output Connection not finished <P1> 


Parameters: P1: Name of the object for which the error occurred. 


Audience: Engineer 
Cause: No response has been received from the previously sent connection(s). 
Action: Configure the object to execute less frequent. 


Error: Bad State 


Parameters: 

Audience: Operator 

Cause: Internal software error which should not occur. The object is stopped. 
Action: Report the error to your nearest Local ABB Support Office. 


Lower level error: <P1> 
Parameters: P1: Name of the object for which the error occurred. 
Audience: Operator 


Cause: This system message is logged together with another log that describes the 
error more thoroughly. 


Action: Look for another system message issued at the same time and take 
appropriate actions according to that. 
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Operation Ignored due to unresolved symbols <P1> 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer 


Some of the connected objects has not been resolved. Therefore the 
execution is not performed. 


Check that the connected object has not been deleted. 


Input Connection timeout (Subscribe/Refresh) 


Parameters: 
Audience: 


Cause: 


Action: 


Operator, Engineer 


The read request of the connected object has passed the allowed time. The 
problem is probably caused by high load on the communication network. 


Check that the same result occurs when reading the connected object via a 
User API program. If not, contact your nearest Local ABB Support Office. 


Object error: OMF unbind error <P1> 


Parameters: 
Audience: 
Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer 
Internal software error which should not occur. The object is stopped. 


Restart the object handler. Report the error to your nearest Local ABB Support 
Office. 


Object error: OMF view creation error <P1> 


Parameters: 
Audience: 
Cause: 


Action: 


P1: Name of the object for which the error occurred. 
Operator, Engineer 
Internal software error which should not occur. The object is stopped. 


Restart the object handler. Report the error to your nearest Local ABB Support 
Office. 
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Property error: Lost reference <P1> 


Parameters: P1: Name of the object for which the error occurred. 


Audience: Service 


Cause: Internal software error which should not occur. The object is stopped. 
The message is combined with another system message. 


Action: Restart the object handler. Report the error to your nearest Local ABB Support 


Office. 


5.3.1.3 Warning messages 


<P1> Script runtime warning 


Parameters: P1: Name of the object for which the warning occurred. 


Audience: Operator, Engineer 


Cause: The script return code in the output vector is greater than zero (and the use 


return code attribute is configured to true). 


Action: No action. 


5.3.1.4 Information messages 
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<P1> MATLAB connection established 


Parameters: P1: Name of the object. 


Audience: Operator, Engineer 
Cause: Object started. 
Action: No action. 
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<P1> MATLAB connection broken 


Parameters: 
Audience: 


Cause: 


Action: 


5.3.2 Off-Line Interface 


5.3.2.1 Error Messages 
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P1: Name of the object. 
Operator, Engineer 


1. The MATLAB command attribute is exit or quit. 
2. The connected MATLAB process is killed. 


1. No action. 
2. Try to find out who killed the process. 


General system messages 


ERROR: The Advatalk Link to MATLAB 
<P1>: FIFO communication failure 


Parameters: 
Audience: 


Cause: 


Action: 


P1: The name of the off-line function that returned the error. 
Engineer, Operator 


1. The server has terminated. 
2. File system full. 


1. Check if the server has terminated. Use the ps command: 
ps -ef | grep matlab_api 

If the server has terminated re-start it: 

>> cd /opt/advant/MatlabLink/bin 

>> offline 

If the server was not terminated. Kill and re-start it. 

>> !kill <matlab_apiserver process id> 


If that fails, consult system responsible. 
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ERROR: The AdvatTalk Link to MATLAB 
<P1>: Could not allocate memory 


Parameters: P1: The name of the off-line function that returned the error. 


Audience: Engineer, Operator 
Cause: Not enough primary memory. 
Action: Try to re-start MATLAB or consult the system responsible. 


ERROR: The AdvatTalk Link to MATLAB 
<P1>: bciDataTypeElements (<P2>,<P3>) API ERROR <P4> 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The name of the attribute. 
P3: The type index. 
P4: The User API return code. 


Audience: Engineer, Operator 
Cause: Interpret the return code. Use the Advainform Basic Functions User’s Guide. 
Action: See the Advalnform Basic Functions User’s Guide. 


ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2> (<P3>) API ERROR <P4> 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The name of the User API function that returned the error. 
P3: The name of the erroneous attribute/object/type. 
P4: The User API return code. 


Audience: Engineer, Operator 
Cause: Interpret the return code. Use the Advainform Basic Functions User’s Guide. 
Action: See the Advalnform Basic Functions User’s Guide. 
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ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2> (<P3>) OBJ CODE <P4> 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The name of the User API function that returned the error. 
P3: The name of the erroneous attribute/object/type. 
P4: The User API object return code. 


Audience: Engineer, Operator 
Cause: Interpret the return code. Use the Advalnform Basic Functions User’s Guide. 
Action: See the Advalnform Basic Functions User’s Guide. 


ERROR: The Advatalk Link to MATLAB 
<P1>: Object <P2> could not be resolved 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The name of the unresolved object. 


Audience: Engineer, Operator 
Cause: The object does not exist or there is high load in the communication network. 
Action: If the object exists, try again after a while. 


ERROR: The Advatalk Link to MATLAB 
<P1>: Invalid data type <P2> <P3> = Invalid 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The object name. 
P3: The attribute name of which the type was invalid. 


Audience: Engineer, Operator 
Cause: Invalid type of the given attribute. 


Action: Select an attribute of valid type. 
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ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2> <P3> = (<P4>) - DATATYPE NOT SUPPORTED 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The object name. 
P3: The attribute name of which the data type is not supported. 
P4: The name of the data type that is not supported. 


Audience: Engineer, Operator 
Cause: Obvious. 
Action: Select an attribute of a data type that is supported. 


ERROR: The Advatalk Link to MATLAB 
<P1>: <P2> (<P3>) <P4> bytes - DATA SIZE NOT SUPPORTED 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The attribute name. 
P3: The attribute type. 
P4: The illegal size of the attribute. 


Audience: Engineer, Operator 
Cause: The size of the attribute is not supported. 
Action: Select an attribute with valid data size. 


ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2> <P3> = (<P4>) [<P5>] - TO MANY ELEMENTS 


Parameters: P1: The name of the off-line function that returned the error. 
P2: The object name. 
P3: The attribute name. 
P4: The name of the data type. 
P5: The number of elements. 


Audience: Engineer, Operator 
Cause: The composite attribute contains too may elements. 
Action: Select another attribute. 
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ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2>,<P3> - ATTRIBUTE NOT FOUND 


Parameters: 


Audience: 
Cause: 


Action: 


P1: The name of the off-line function that returned the error. 
P2: The object name. 
P3: The name of the attribute that was not found. 


Engineer, Operator 
The attribute does not exist in the object type. 


Select a valid attribute. 


ERROR: The Advatalk Link to MATLAB 
<P1>: Failed to connect user: <P2> 


Parameters: 


Audience: 
Cause: 


Action: 


P1: The name of the off-line function that returned the error. 
P2: The name of the user that was not connectable. 


Engineer, Operator 
The user does not exist. This error shall not occur. 


Contact your nearest Local ABB Support Office. 


Function specific system messages 


ERROR: The AdvatTalk Link to MATLAB 
getAttribute: Invalid attribute value - <P1> 


Parameters: 
Audience: 


Cause: 


Action: 


P1: Name of attribute for which the error is returned 
Engineer, Operator 


Attribute value can not be converted to a double with a “meaning”. The 
attribute may be of the string type. 


Choose another attribute. 
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ERROR: The Advatalk Link to MATLAB 
getHistory: ERROR in mktime calculation 


Parameters: 

Audience: Engineer, Operator 

Cause: .The calendar time cannot be represented. This fault shall not occur. 
Action: Contact your nearest Local ABB Support Office. 


ERROR: The AdvatTalk Link to MATLAB 
getMultiDAT: Error in return array. 


Parameters: 

Audience: Engineer, Operator 

Cause: Erroneous return array. This error should not occur. 
Action: Contact your nearest Local ABB Support Office. 


ERROR: The AdvatTalk Link to MATLAB 
logAttribute: Broken pipe 


Parameters: 

Audience: Engineer, Operator 

Cause: The communication with the output file is broken. 
Action: Start a new logAttribute process. 


ERROR: The Advatalk Link to MATLAB 
logAttribute: Could not open input data file 


Parameters: 

Audience: Engineer, Operator 

Cause: The data file given as the third input argument, cannot be opened. The file 
does not exist or the wrong path has been given. 

Action: Create the file or correct the given path. Remember that the whole path has to 


be given. 
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ERROR: The Advatalk Link to MATLAB 
logAttribute: Could not open temporary file 


Parameters: 

Audience: Engineer, Operator 

Cause: A temporary file cannot be opened. This error shall not occur. 
Action: Contact your nearest Local ABB Support Office. 


ERROR: The AdvatTalk Link to MATLAB 
logAttribute: Could not open output file 


Parameters: 

Audience: Engineer, Operator 

Cause: The output data file cannot be opened. This error shall not occur. 
Action: Contact your nearest Local ABB Support Office. 


ERROR: The Advatalk Link to MATLAB 
logAttribute: Minimum sample time: <P1> second 


Parameters: P1: The minimum sample time allowed in seconds. 


Audience: Engineer, Operator 
Cause: To short sample time given in the first input argument. 
Action: Increase the value. 


ERROR: The Advatalk Link to MATLAB 
logAttribute: Minimum number of samples: <P1> 


Parameters: P1: The minimum number of samples allowed. 
Audience: Engineer, Operator 
Cause: To few samples given in the second input argument. 


Action: Increase the value. 
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ERROR: The Advatalk Link to MATLAB 
listMatrix: Too long search string (max 20 characters) 


Parameters: 

Audience: Engineer, Operator 

Cause: The string given as input parameter is too long. 
Action: Give a shorter search string. 


ERROR: The AdvatTalk Link to MATLAB 
listMatrix: No matrix(es) found when searching for ‘<P1>’ 


Parameters: P1: The matrix name given as input argument. 


Audience: Engineer, Operator 
Cause: The matrix or matrices called for doesn’t exist. 
Action: Change the search string or omit the input argument. 


ERROR: The Advatalk Link to MATLAB 
readMatrix: Matrix <P1> was not found 


Parameters: P1: The name of the matrix that was not found. 


Audience: Engineer, Operator 
Cause: The matrix does not exist in the database. 
Action: Give another name or store a matrix with that name before trying to read it. 


ERROR: The Advatalk Link to MATLAB 
storeMatrix: Matrix name too long. Maximum 20 characters 


Parameters: 

Audience: Engineer, Operator 

Cause: The given name in the first input argument is too long. 
Action: Give a shorter name. 
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ERROR: The AdvatTalk Link to MATLAB 
storeMatrix: Matrix description too long. Maximum 40 characters 


Parameters: 

Audience: Engineer, Operator 

Cause: The given description in the second input argument is too long. 
Action: Give a shorter description. 


ERROR: The AdvatTalk Link to MATLAB 
Matrix with the name <P1> is already stored: 


Parameters: P1: The name of the matrix that is already stored. 


Audience: Engineer, Operator 
Cause: Trying to store a matrix in the database with a name that already exists. 
Action: Change the name of the matrix given as the first inout argument. 


ERROR: The AdvatTalk Link to MATLAB 
setObj: Illegal object type (<P1>) of object (>P2>) 


Parameters: P1: The name of the illegal object type. 
P2: The name of the object that is of illegal object type. 


Audience: Engineer, Operator 
Cause: Trying to set an object that is not of a valid type. 
Action: Use the on-line help for the function to find out which the valid object types are. 


Try only to set objects of such types. 


ERROR: The Advatalk Link to MATLAB 
Illegal attribute (<P1>) of object (<P2>) 


Parameters: P1: The name of the illegal attribute. 
P2: The name of the object that has a illegal attribute given as argument. 


Audience: Engineer, Operator 
Cause: Trying to set a not valid attribute of an object. 
Action: Use the on-line help for the function to find out which the valid attributes are. 
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ERROR: The Advatalk Link to MATLAB 
setObj: Illegal value (<P1>) of object (<P2>) 


Parameters: 


Audience: 


Cause: 


Action: 


P1: The illegal value. 
P2: The object to which the illegal value belongs to. 


Engineer, Operator 


The value given as input argument cannot be converted to a integer or double 
value. 


Give a valid input value. 


ERROR: The AdvatTalk Link to MATLAB 
setObj: CHANGE ORDER to <P1> returned status <P2>, TEXTINDEX <P3> 


Parameters: 
Audience: 
Cause: 


Action: 


5.3.2.2 Warning Messages 
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See the Advalnform Basic Unit User’s Guide. 
Engineer, Operator 
See the Advalnform Basic Unit User’s Guide. 


See the Adva/nform Basic Unit User’s Guide. 


ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2> (<P3>) API ERROR <P4> 


Parameters: 


Audience: 
Cause: 


Action: 


P1: The name of the off-line function that returned the error. 
P2: The name of the User API function that returned the error. 
P3: The name of the erroneous attribute/object/type. 

P4: The User API return code. 


Engineer, Operator 
Interpret the return code. Use the Adva/nform Basic Functions User's Guide. 


See the Adva/nform User API User’s Guide. 
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ERROR: The AdvatTalk Link to MATLAB 
<P1>: <P2> (<P3>) OBJ CODE <P4> 


Parameters: 


Audience: 
Cause: 


Action: 


5.3.2.3 Information Messages 
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P1: The name of the off-line function that returned the error. 
P2: The name of the User API function that returned the error. 
P3: The name of the erroneous attribute/object/type. 

P4: The User API object return code. 


Engineer, Operator 
Interpret the return code. Use the Advainform Basic Functions User’s Guide. 


See the Adva/nform User API User’s Guide. 


logAttribute: Previous sample not finished 


Parameters: 
Audience: 


Cause: 


Action: 


Engineer, Operator 


The operations performed in the previous sample takes too long time. The 
given sample time becomes to short. 


The data collection can be slow depending on high load in the communication 
network. 


The number of objects to read can be too large. 


Increase the sample time or reduce the number of objects to read. 
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5.4 Fault Finding and User Repair 


The tools for finding the cause of a malfunction in your IMS system are: 


The message on your screen 


Normally, the message is sufficient for you to fix the problem. For messages from Oracle 
tools the oerr on-line tool is also available. 


The System Message display 


To understand messages from the Link to MATLAB and options you can find more 
information in Section 5.3 Error Messages. In the Advalnform Basic Functions User's 
Guide you can learn how to use the display and what features that are available. The 
System Message Display also lets you display each error log with more details about it. 


The Oracle trace files 


The information in those files together with the oerr on-line tool will help you. In the 
Advant Station 500 IMS User’s Guide you can find information about the trace files and 
how to use the tool. 


The System Status displays 


The Advalnform Basic Functions User’s Guide provides information regarding the System 
Status displays. For example, you can check whether a process related to your problem is 
running or not. 


Before you do extensive trouble-shooting, make sure there is no simple reason for your 
problem. For example, make sure that you are authorized to perform the function you are trying 
to do. Make sure there is nothing in your configuration data that spoils the function and so on 


5.4.1 Off-Line Interface 


The first thing you should do when any fault occurs is to review the information in this manual 
and use the on-line help for each function, to see if you have made any errors yourself. If you 
cannot find the cause of the problem there may be an error in the software. 
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If the fault can be identified as software error, the error shall be reported to your nearest Local 
ABB Support Office. 
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5.4.2 On-Line Interface 


5.4.2.1 Object Configuration 


The first thing you should do when any fault occurs is to review the information in this manual 
and the configuration Help function to see if you have made any errors yourself. If you cannot 
find the cause of the problem, there are two possibilities: 


° The Object Configuration tool has a software error, or 
° There is a problem in the run time environment. 


Before concluding that there is an error in the Object Configuration tool, check the run time 
environment according to the instructions given in the following section. 


5.4.2.2 Run Time Environment 


If your application is not working properly, if you suspect there is an error when you are 
working with the Object Configuration tool, try the following to determine the cause of the 
problem. Check with the system messages display which is started from the IMS menu. Please 
Note that You can save a complete information about each message on disk from the Examine 
window. 


Check the System Messages and the System Status (Master) displays. They are both started 
from the Station menu of the IMS main window. 


Use the Node Status display for you own node to determine if the object handler is no longer 
active. Use the System Messages for explanations. Write down the system messages to be able 
to file an error report. The name of the object handler is: 


Master 


matlablinkhandler 


MOD 300 


modmatlablinkhandler 


See the errors described in Section 5.3.1, On-line Interface, for explanations of, and actions to 
correct, errors that have occurred. If you need to restart the object handler, refer to Section 2.4, 
Start-up Procedures for re-start of the IMS. 


If the fault can be identified as a software error, the error shall be reported to your nearest Local 
ABB Support Office. 
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A.1 On-line Functionality 


A.1.1 Input Vector Organization 


The input data is sent to the MATLAB workspace as a vector. It contains all input values, 
both configured connections and not configured connections, together with some other useful 
information. The input data vector is addressed in the same way as any other MATLAB vector 
or matrix. 


Float and boolean values are grouped together as described in Figure A-1. The input vector is 
treated as a full, real matrix in the MATLAB environment. Each position in the input vector is 
outlined bellow. 


° Float Input part - the values that is read from the float input connections. 
° Boolean Input part - the values that is read from the boolean input connections. 
° Use Return Code - the value that indicates that the return code function should be used. 


° Header ID - Used in MATLAB workspace to separate instances that have the same input 
vector name. 


° First Execution - Used in MATLAB workspace to indicate if it is the first time the instance 
is executed (value = 1). 


Position number in the input vector: 


1 64 65 96 97 98 99 100-120 
Use return First Exec. Not 
Fl | Bool | P 
oat Input part oolean Input Part Seo Header ID AG eee 
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Figure A-1. Design of the input vector sent to the MATLAB workspace 


The name of the input vector that is sent to the MATLAB environment is configured in an 
attribute, INPUT_VECTOR_NAME, of each object instance of the MatlabLink type. This name 
should be used in the MATLAB script that is intended to be executed by that instance. 


No check is made whether the same name is used in any another instance. If the same vector 
name is used in more than one instance, values in that vector are changed in the MATLAB 
environment at every execution of a instance with the same vector name. 
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A.1.2 Output Vector Organization 


The output data vector is created in the MATLAB workspace. The output data vector is 
addressed in the same way as any other MATLAB vector or matrix. 


Float and boolean values are grouped together as described in Figure A-2. The output vector is 
treated as a full, real matrix in the MATLAB environment. 


Each position in the output vector is outlined bellow. 
° Float Output part - the values that are used to update the real output connections. 


° Boolean Output part - the values that are used to update the boolean output connections. 


Position number in the output vector: 


1 16 17 32 33 34 35-50 
: Return Send Event Not 
Float Output part Bool Output part: 1/0 
Bat UIpot pal Bee enced Code Authorization used 


Figure A-2. Design of the Output vector sent from the MATLAB environment. 


The name of the output vector, that is sent from the MATLAB environment is configured in an 
attribute, OUTPUT_VECTOR_NAME, of each object instance of the MatlabLink type. This 
name should be used in the MATLAB script that is intended to be executed by that instance. 


No check is made whether the same name is used in any another instance. If the same vector 
name is used in more than one instance, values in that vector are changed in the MATLAB 
environment at every execution of a instance with the same vector name. 


A.2 Database Description 


A-2 


The off-line interface storage of matrices from the MATLAB workspace take place in an option 
specific tablespace in the Oracle DB. Information is stored in two tables called matrix and 
matrix_values. 


MATRIX table 


Contains the name, description, storage date and size of the stored matrix. It also contains an 
identification number which points out the rows in the matrix_values table that belongs to the 
stored matrix. 


An example of the contents of the matrix table can be viewed in Table A-1. 
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Table A-1. The MATRIX table 


MATRIX_NAME | DESCRIPTION ) STORAGE_DATE | MATRIX_ID | NO_OF_ROWS | NO_OF_COLS 
test small 1996-09-10 12.00.05 1 10 10 
test2 medium 1996-09-10 12.00.10 2 100 100 
test3 large 1996-09-10 12.00.15 3 1000 1000 
MATRIX_VALUES table 
Each row in the table can hold 250 values of the type NUMBER(16,4). A row also contains the 
identification number from the matrix table and a row index that is used if more than one row is 
required when storing the values. 
The values are stored in a special way in the database. When reading the values from the 
MATLAB workspace, MATLAB reads the values column by column. 
An example: 
If you have a matrix in MATLAB that looks like: 
test4 = : : ] 
456 
It will be stored as in table Table A-2. 
Table A-2. MATRIX_VALUES table 
MATRIX_ID | ROW_ID | VALUE1 | VALUE2 | VALUE3 | VALUE4 | VALUES | VALUEEG | ............. 
4 1 1 4 2 5 3 6 


A.3 Off-line Functionality 


A.3.1 resolveObj 
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In general, all error information and string messages will be printed in the MATLAB terminal 
window. 


Purpose 


Resolve all defined object names given as input. 
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A.3.2 describeObj 
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Synopsis 

status = resolveObj(’object_namel’, [’object_name2’],...) 
or 

resolveObj(’ object name 1’, [’object_name2’],...) 

Description 


This function will issue a name brooking request that will try to resolve each object name that is 
given as input parameter. A message is sent to the MATLAB screen for each object name 
weather the object was resolved or not. The function must be reissued by the user for those 
objects that are not resolved. No upper limit exists for the number of objects that can be 
resolved in each call. 


One result matrix is supported. It is used for the function return status, that is 0 on a successful 
completion of the function and -1 otherwise. 


Examples 


>> resolveObj(’AI_TEST_1’,’AI_TEST_2’) 


Object AI_TEST_1 was resolved. 
Object AI_TEST_2 could not be resolved. 


E 


>> 


Purpose 


Present the available attributes for an object name or object type. 


Synopsis 


status = describeObj(’object_name or object_type’ ) 
or 
describeObj(’object_name or object_type’ ) 


Description 


This function will print all available attributes of an object name or object type in the MATLAB 
terminal window. An object that are not yet resolved will be resolved prior to the operation. 
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One result matrix is supported. It is used for the function return status, that is 0 on a successful 
completion of the function and -1 otherwise. 


Available types are all types present in the IMS Type Directory. 


Examples 


>> decribeObj(’AI’) 


-Attributes Data type Siz 
NAME STRING 21 byte 
DESCRIPTION STRING 29 byte 
STATUS BITSET 4 byte 
>> 

A.3.3 getAttribute 
Purpose 


Read attribute values of an object. 


Synopsis 

[data, status] = getAttribute(’obj_name’,’attribl’,’attrib2’,..) 
or 

data = getAttribute(’obj_name’,’attribl’,’attrib2’,..) 
or 


getAttribute(’obj_name’,’attribl’,’attrib2’,..) 


Description 


This function will collect attribute values from the object given as input parameter. All object 
types that are present in the IMS Type Directory are available. If an object is unresolved, the 
function will try to resolve the instance, prior to reading the requested attributes. If the resolve 
operation is not successful, an error message is printed on the MATLAB screen. 


The attributes that are requested will be specified as input parameters to the function together 
with the object name. Some limits concerning what attributes that can be used are implemented. 
Only those attributes that can be converted to a double value with a “meaning” are accessible. 
For example, the double representation of string attributes is to no use. 
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A.3.4 getMultiDAT 
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None, one or two result matrices can be used. If two result matrices are used, the first matrix 
will contain the attribute values and the second one the function return status on a successful 
completion of the function. If the function fails, they will both contain -1. 


If only one result matrix is given, it is used for the attribute values returned. If the function fails, 
it will be empty. 


If no matrix is used the attribute values will reside in the MATLAB ans variable on a successful 
completion of the function. 


Examples 


>> data = getAttribute(’AI_TEST_1’,’VALUE’,’STATUS’,’HI_LIM2’ ) 


data = 
23 
63 
100 

>> 

Purpose 


Read a MultiDAT object value array. 


Synopsis 
[data, status] = getMultiDAT(’ startDATname’ ,noOfDATs,’type’ ) 


or 


data getMultiDAT(’startDATname’ ,noOfDATs,’type’ ) 


type = R_: Real part 
IL: Integer Long 


Description 


A Multi DAT is by definition a number of DAT objects of the same type in a consecutive order. 
The maximum number of objects in one MultiDAT is limited to 50 objects (one value from 
each). 


The value sent to MATLAB will be an array of double values independent of the type used in 
the request. 


None, one or two result matrices can be used. If two result matrices are used, the first matrix 
will contain the object values and the second one the function return status on a successful 
completion of the function. If the function fails, they will both contain -1. 
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If only one result matrix is given, it is used for the object values returned. If the function fails, it 
will be empty. 


If no matrix is used the object values will reside in the MATLAB ans variable on a successful 
completion of the function. 


Examples 


>> [data,status] = getMultiDAT(’DAT73_1’,3,’R’) 


data = 
23 
56 
12 
status = 
0 
>> 
A.3.5 logAttribute 
Purpose 


Collect attribute values cyclic and store them in an ASCII file. 


Synopsis 


status = logAttribute(sample_interval_in_seconds, 
number_of_samples, 
‘input_datafile_name’ ) 


or 


logAttribute (sample_interval_in_seconds, 
number_of_samples, 
‘input_datafile_name’ ) 


Description 


This function will log attribute values and store them in an ASCII file with a 16 digits and 6 
decimal accuracy. No limit is implemented concerning the number of object attributes logged or 
the number of samples allowed. It is up to the user to take care of that thera are enough memory 
and disk space available. 


None and one result matrix will be supported. If one result matrix is used it will contain the 
function return status, that is -1 if an error occur and 0 otherwise. If no result matrix is used the 
function return status will reside in the MATLAB ans variable. 
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The time between each sample can be configured and defined in seconds (multiples of 1 second) 
in the first input parameter. 


The number of samples is defined in the second input parameter. 


The combinations of object names and attributes that will be logged are given as input in a text 
file. The name of this file is given as the third input parameter to the function. The syntax of the 
input file is checked before starting the logging. If a syntax error occurs, no logging is started. 


The full path to where the input data file reside shall be used. The input data file should have the 
following syntax: 


object name 1, attribute 1 
object name 2, attribute 2 
object name 3, attribute 3; 
object name 4, attribute 4 
object name 5, attribute 5 


A “subscription” is set up using the UserAPI functionality. When the UserAPI application has 
started, the MATLAB prompt will be free for usage. This means that the log function is 
executing independent of the MATLAB process. Other operations will be possible to execute 
during the log period. 


If a requested object or log is not resolved, an error text is printed in the MATLAB terminal 
window informing the user which object that is not resolved. In the logAttribute function, the 
latest received value is stored if the cyclic subscription fails to read the requested value. 


Storage of values as an ASCII file, is done independent of MATLAB. The output data file is 
stored in the directory /home/opt/advant/MatlabLink/logdata. The name of the resulting logfile 
is input-file-name<creation date>.data (The date command: date +%a%d%b%HUM%S is used 
to create the date as part of the file name). 


A vector of values is written to file for each sample. The function will not buffer any values. 
This makes it possible to read the file at the same time as the logging is active. The value 
delimiter used is a space and each row is terminated with EOL as in standard ASCII text files. 


A time stamp given in UTC format for will be stored as the first value for each new sample with 
a micro second resolution. 


If logging must be terminated or stopped, the Unix command kill <logAttribute process id> 
can be used. To find out the process identity of the logAttribute program use the standard Unix 
command ps -e | grep logAttribute. The log function handles how to close the log file when 
terminated as well as all other signals that can be of any relevance. The stored part of the log file 
is available for reading and is not removed when the log function is killed. 


The log file can be loaded into the MATLAB workspace by the MATLAB command “load”. 
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Examples 
>> status = logAttribute(1,3600,’datafile’ ) 


status = 


>> 


This will give a output file in the logdata directory named datafile<date>.data. 


Purpose 
To set (change) a value of an object attribute. 
Synopsis 


status = setObj(’object_namel’,’attribl’,valuel, 
[’object_name2’,’attrib2’,value2],....) 


or 


setObj (’object_namel’,’attribl’,valuel, 
[’object_name2’,’attrib2’,value2],....) 


Description 
This function is used to set (change) one attribute value for each supplied object name. 


Allowed object types and attributes are: 


Master 
1. DAT 

- Attributes: IL_VAL, BO_VAL, R_VAL, IW_VAL 
2. MultiDAT 


— Attributes: IL_VAL, BO_VAL, R_VAL, ITW_VAL 
3. TEXT 
—  TEXT_REAL, TEXT, INT_LONG 
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MOD 300 
1. DATA_FCM 

— Attributes: DATA1 to DATA20 
2. VA_STRING_FCM 

— Attributes: RESULT, SVALUE 


None and one result matrix will be supported. If one result matrix is used it will contain the 
function return status, that is -1 if an error occur and O otherwise. If no result matrix is used the 
function return status will reside in the MATLAB ans variable. 


Examples 


>> setObj(’DAT71_1’,’R_VAL’,12.67) 


setObj: Setting REAL input value of DAT71_1 to 12.67 


>> 


A.3.7 History access - getHistory 
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Purpose 


To read numerical history values from any AdvaInform History log or Master TTD log into 
MATLAB workspace. 


Synopsis 


[data,status] = 
getHistory(‘name’, [time,’S|M|H|D’, [no_of_val, [ ‘YYMMDD 
HHMMSS’ ]]]) 


or 


data = getHistory(‘name’, [time,’S|M|H|D’, [no_of_val, [ ‘YYMMDD 
HHMMSS’]]]) 


Description 


In order to use this function against History logs the AdvaInform History option must be 
available. Otherwise only TTD logs can be accessed (Master). 


This function retrieves History numeric data from a named History numeric log or TTD log 
(Master). By default the last 60 minutes or 400 values up to present time of current History 
numeric data is collected raw. 
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None, one or two result matrices can be used. If two result matrices are used, the first matrix 
will contain the collected data and the second one the function return status on a successful 
completion of the function. If the function fails, they will both contain -1. 


If only one result matrix is given, it is used for the data returned. If the function fails, it will be 
empty. 


If none matrix is used the collected data will reside in the MATLAB ans variable on a successful 
completion of the function 


The result matrix that contains the retrieved data has tree columns. The first one contains the 
absolute UTC time of each sample, the second one the entryvalue (data) from the log and the 
third one is the entrystatus of the entryvalue. 


The different kind of entrystatus that can appear are documented in Advalnform History User's 
Guide. They are also available in the on-line help for the function. 


Parameters: 

° ‘log_name’ - log name or access name of the History Numeric Log or TTD log (Master). 
° time - “time” seconds, minutes, hours or days asked for up to present time. 

*  ‘S|MIHID’ - the units for time, see previous parameter. 

° no_of_val - the number of log entries to collect (max 500) 


° “YYMMDD HHMMSS’ - selection DATE and TIME part. Entries up to this time are 
collected. 


Defaults: 


time = 60 M, no_of_val = 400, ‘YYMMDD HHMMSS’ = present time 
Examples 

NLog! is an numeric log with the sample interval 10 seconds. 

>> resl=getHistory(‘NLogl’,10,’S’,1) 


Requested data @96-04-23 12:58:43 SINGLE from NLogl, Waiting 


resl = 

1.0e+08 * 

8.3026 0 0.0000 6The first column is the UTC time. 
>> 
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A.3.8 Database storage - storeMatrix 
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Purpose 
To store real, MATLAB matrices from MATLAB workspace in the AdvalInform database. 
Synopsis 
status = storeMatrix(’matrix_name’, ‘description’ ) 
or 
storeMatrix(’matrix_name’, ’description’ ) 
Description 


This function stores an existing matrix from MATLAB workspace in the AdvaInform database. 


When a matrix is stored in the AdvaInform database, it is also available to any software that can 
use SQL queries or from another database that can communicate with the AdvaInform database. 


The matrix values are together with the number of rows, number of columns, date and a 
description, stored in the database. No size limits are implemented on the matrix size. If the 
matrix name already exists, an error message will be issued and no storage will occur. 


None and one result matrix is supported. It is used for the function return status, that is -1 if an 
error occur and 0 if storage was successful. 


Examples 


>> matrixl = [1 2 3; 1 2 3]; 
>> storeMatrix(‘matrixl’,’test matrix 1: 2x3’) 


storeMatrix: Matrix matrixl successfully stored. 


>> 
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Purpose 


To read any previously stored matrix from the AdvaInform database and load it into the 
MATLAB workspace as a real, full MATLAB matrix. 


Synopsis 

[data, status] = readMatrix(’matrix_name’ ) 
or 

data = readMatrix(’matrix_name’ ) 
or 


readMatrix(’matrix_name’ ) 


Description 


The values read from any stored matrix in the AdvaInform database are copied into the 
MATLAB workspace. 


None, one or two result matrices can be used. If two result matrices are used, the first matrix 
will contain the retrieved matrix values and the second one the function return status on a 
successful completion of the functionO. If the function fails, they will both contain -1. 


If only one result matrix is given, it is used for the values returned. If the function fails, it will be 
empty. 


If none matrix is used the retrieved values will reside in the MATLAB ans variable on a 
successful completion of the function 


Examples 
>> resl = readMatrix(‘matrixl’) 
resl = 
14° 2% 3 
De 2:3 
>> 
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A.3.10 listMatrix 


Purpose 

To list matrices that are stored in the AdvaInform database. 

Synopsis 

status = listMatrix(*[matrix_name or search_string]’) 
or 

listMatrix(‘*[matrix_name or search_string]’) 


Description 


This function will list the name, description, storage time and the matrix size of stored matrices 
in the AdvalInform database in the MATLAB window. 


One result matrix is supported for function return status, that is -1 if an error occur and 0 if the 
operation was successful. 


Examples 


oe 


>> listMatrix (‘%ix1%’ ) %' is wildcard 


—Name-——-— Description-—-------— StorageDat Rows-——Columns-— 
matrixl test matrix 1: 2x396-03-10 08.54.342 5) 
>> 
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A.3.11 deleteMatrix 
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Purpose 
To remove a previously stored matrix from the AdvaInform database. 
Synopsis 
[status] = deleteMatrix(’matrix_name’ ) 

or 
deleteMatrix(’matrix_name’ ) 


Description 


One result matrix is supported for the function return status, that is -1 if an error occur and 0 if 
the operation was successful. 


Examples 

A real example of usage should be included. 

>> deleteMatrix(‘*matrixl’ ) 

deleteMatrix: Matrix matrixl is deleted. 


>> 
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